Docs
← Back to site

Single-Product vs. Multi-Product Mode

2 min readUpdated November 21, 2026

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).

The Single-product mode setting with the "I only have one product" checkbox.

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?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only