Skip to main content

​
SEO and GEO maintenance

This document defines the ongoing SEO and GEO (Generative Engine Optimization) maintenance process for docs.novu.co.

​
Monthly Google Search Console review

  1. Open Google Search Console for docs.novu.co.
  2. Review Queries for the notification infrastructure keyword cluster:
    • notification infrastructure
    • in-app notification component
    • notification API
    • Novu inbox
    • transactional notifications
  3. Prioritize pages with high impressions but low CTR (rewrite title/description).
  4. Prioritize pages with low average position on target queries (expand content depth, add internal links).
  5. Submit or verify https://docs.novu.co/sitemap.xml in the Sitemaps report.

​
Pre-deploy checklist

Before merging documentation changes:
  • Every new MDX page has unique title and description frontmatter
  • API endpoint pages include a description and 1–2 sentence intro before the OpenAPI block
  • Provider pages use the {Provider} {Channel} Integration with Novu title pattern
  • Headings on key pages use question format where appropriate
  • Images include descriptive alt text
  • Run mint broken-links from the docs/ directory (requires Mintlify CLI)
  • Run mint score to validate SEO/GEO signals including robotsTxtAllowsAI

​
Quarterly AI citation testing

Test these questions in ChatGPT, Perplexity, and Claude:
  1. How do I authenticate API requests with Novu?
  2. What are Novu API rate limits?
  3. How do I add in-app notifications to a Next.js app?
  4. What is Novu and what channels does it support?
  5. How do Novu workflows work?
  6. How do I send a transactional notification with Novu?
  7. What is Novu Inbox?
  8. How do I migrate from Knock to Novu?
  9. Can I self-host Novu?
  10. What is Agent Communication Infrastructure (ACI)?
For each response, verify:
  • Whether docs.novu.co is cited
  • Whether cited content is accurate
  • Whether code examples match current API patterns
Log inaccurate citations and update the corresponding documentation page.

​
Technical references

  • llms.txt: https://docs.novu.co/llms.txt (Mintlify auto-generated)
  • sitemap.xml: https://docs.novu.co/sitemap.xml
  • robots.txt: https://docs.novu.co/robots.txt
  • Mintlify SEO config: docs.json → seo block

​
Target keyword ownership