Welcome to WP Super Docs
WP Super Docs is a multi-product documentation system for WordPress. It gives you a clean, standalone /docs/ section on your site, separate from your theme’s blog or pages, with auto-generated navigation, a product switcher, and a full set of tools for writing, organizing, versioning, and searching documentation.
It’s built for SaaS companies and plugin/theme authors who need to document one product, or many.
Single product or many#
WP Super Docs works either way, and it adapts automatically:
- If your site only has docs for one product, the plugin quietly runs in single-product mode. No product switcher, no extra “which product” step for readers.
- If you add docs for a second product, it switches to full multi-product mode on its own, showing a product index and switcher.
- You can also force single-product mode from Settings → General if you prefer, regardless of how many products exist.
You don’t have to decide this up front. Just start writing, and the plugin figures out the right layout as your docs grow.
How your content is organized#
Everything in WP Super Docs is built on one custom post type, Docs, and three taxonomies:
| Taxonomy | Purpose |
|---|---|
| Product | Which product a doc belongs to (e.g. “My Plugin,” “My Theme”) |
| Category | Topic grouping within a product (e.g. “Getting Started,” “Settings”) |
| Tag | Freeform labels used for cross-linking and the Related Docs feature |
A doc’s URL reflects this structure directly:
/docs/{product}/{category}/{doc}/
The product segment is always present in the URL, even when you only have one product. For example: /docs/main/getting-started/welcome-to-wp-super-docs/. Product slugs work like any standard WordPress taxonomy term: they’re generated from the product title you enter, and you can edit them yourself under the product’s slug field. For single-product sites, we recommend setting the slug to main, but you’ll need to set that yourself when creating the product, the same way you would for any WordPress category or tag slug.
What you can do with a doc#
Once you’re writing, WP Super Docs adds a set of building blocks on top of normal WordPress content:
- Callouts: info, tip, warning, danger, and note boxes
- Code blocks: syntax highlighting, a copy button, and multi-language tabs
- Diagrams: Mermaid flowcharts and diagrams
- Math notation: KaTeX-rendered equations
- Status badges: mark a doc New, Updated, Beta, or Deprecated
- Table of contents: generated automatically from your headings
- Related docs: surfaced automatically based on shared tags, category, and product
Beyond the writing itself#
WP Super Docs also covers everything around the content:
- Navigation & appearance: auto-generated sidebar nav, or arrange it yourself with drag-and-drop; light/dark mode; your own colors and branding
- Versioning: multiple versions per product, version groups linking the same doc across versions, and draft versions you can hide until release
- Search: a fast built-in frontend search, with the option to hand search off to SearchWP, Relevanssi, Ivory Search, Algolia, or Elasticsearch instead
- Changelogs: a dedicated changelog post type per product, an embeddable “What’s New” widget, and an RSS/email digest of doc updates
- Workflow & access: preview links for unpublished docs, a review workflow with states and notifications, a content health dashboard, and internal-only docs for content that shouldn’t be public
- Multilingual & SEO: WPML and Polylang support, RTL languages, schema.org markup, Open Graph tags, and an automatic sitemap
- Importing: bring existing docs in from WeDocs, Intercom, HelpScout, BetterDocs, or plain Markdown files
- AI features (optional): AI-powered search, connected to OpenAI or Anthropic
Requirements#
- WordPress 6.0 or later (tested up to 7.0)
- PHP 7.4 or later
Was this helpful?
Thanks for your feedback!
✓ Feedback received. Thank you!