Docs
← Back to site

Enabling Versioning for a Product

2 min readUpdated November 21, 2026

Versioning lets a product have multiple releases (v1.0, v2.0, and so on), each with its own set of docs, and a version dropdown in the topbar for readers to switch between them.

Turn on versioning#

Go to WP Super Docs → Settings → General and turn on Doc versions under Products and versions.

The Doc versioning setting: Enable per-product doc versioning.

This is a single sitewide switch. With it off, versioning is completely dormant: no version taxonomy, no dropdown, no effect on any product. Only turn it on if you actually need multiple versions per product; if you only ever ship one current set of docs, leave it off.

Create a version#

Go to WP Super Docs → Versions. Add a new version:

  • Name: for example, “v2.0.”
  • Product: which product this version belongs to. Each version belongs to exactly one product, so “v1.0” for Product A and “v1.0” for Product B are two separate, independent version terms.
The Doc Versions screen with the Add New Version form and the versions of Lumen Forms.

Versions are hierarchical, so if you want to nest patch releases under a major version (v2.0 → v2.1 → v2.1.3), you can set a parent version the same way you’d set a parent category.

Set the default version#

Go to WP Super Docs → Products and edit the product you just added a version to. A Default version field appears once the product has at least one version:

  • Auto (use newest version): always shows whichever version was created most recently.
  • A specific version: always shows that one by default, even if newer versions exist.
The Default version setting on a product: Auto (use newest version) or a specific version.

This is what readers see when they land on the product without picking a version themselves.

Assign docs to a version#

While editing a doc, check its version in the Doc Versions panel in the sidebar, the same way you’d assign a category.

Docs with no version checked stay visible in every version of that product. This means turning on versioning for a product with existing docs doesn’t hide anything; your current docs keep showing up everywhere until you deliberately assign them to a specific version.

What readers see#

The docs topbar with the version picker next to the product switcher.

Once a product has at least one version, a version dropdown appears in the topbar (see Sidebar & Topbar Overview), and the sidebar shows only the docs belonging to the currently selected version, plus any docs with no version assigned. Versions never appear in the URL; switching versions is a filter applied on top of the same URLs, not a separate set of pages.

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