Single-Product vs. Multi-Product Mode
WP Super Docs can document one product or many. Which mode you use changes what your readers see: the product switcher, the products index, and the URL structure all depend on it.
Multi-Product Mode#
This is the default. Use it if you’re documenting more than one product (for example, a plugin and a theme, or several plugins) from the same WordPress site.
In multi-product mode, readers see:
- A products index at
/docs/ - A product switcher in the topbar
- A Products picker when writing or editing a doc, so you can assign it to the right product
Single-Product Mode#
Use this if you only have one product to document. Turning it on:
- Hides the product switcher in the topbar
- Hides the Products picker in the doc editor
- Skips the products index, taking readers straight to your docs
To turn it on, go to WP Super Docs → Settings → General and turn on I only have one product in Products and versions.
Setting up for single-product mode#
When you turn single-product mode on, WP Super Docs sets up the product for you. If there’s no product with the slug main yet, it creates one called “Documentation” with that slug. Every doc that doesn’t have a product yet is assigned to it; docs that already belong to a product keep it.
You can rename the product under WP Super Docs → Products. Keep the slug main: it keeps your doc URLs short and consistent, and it’s the product /docs/ shows (see below).

Even in single-product mode, the product slug is always part of the URL. With the slug set to main, a doc’s URL looks like:
/docs/main/getting-started/welcome-to-wp-super-docs/
Switching modes later#
You can turn single-product mode on or off at any time from Settings → General. If you later add a second product, you’ll need to turn single-product mode off yourself. The setting stays on until you switch it off, even if you have more than one product with docs.
While single-product mode is on and more than one product exists (a leftover test product, say), /docs/ shows the product whose slug is main. If none has that slug, it shows the one product that has docs, or the first product if none do. This is one more reason to use main as the slug.
Was this helpful?
Thanks for your feedback!
✓ Feedback received. Thank you!