Docs
← Back to site

Creating and Managing Categories

4 min readUpdated November 6, 2026

Categories group your docs by topic within a product, and drive the “Browse by category” cards on each product page.

Add a category#

  1. Go to WP Super Docs → Doc Categories.
  2. Select the product tab you want this category filed under (see the note below on what this does and doesn’t mean).
  3. Click + Add category and fill in a Name and optional Description. The slug is generated from the name automatically.
  4. Save.

For the slug, parent category, or icon, use Edit on the category afterward, which opens the full edit screen. See The Doc Categories Page for the complete page.

The Doc Categories page with the categories of one product, their doc counts and the New category button.

A share image for a category#

Each category can have its own share image, the picture shown when its page is shared on Facebook, LinkedIn, X or in chat apps. Click Edit on the category, find Share image, click Choose image and save. Images of 1200 × 630 pixels work everywhere.

Share image field on a category's edit screen

Leave it empty to use the Category pages image from Settings → SEO → Share images. See Share Images.

Categories are shared across products, not scoped to one#

Unlike products, categories aren’t tied to a single product. The same category (for example, “Settings”) can be used by docs in any product. A doc’s URL nests the category under whichever product it’s assigned to, but the category term itself isn’t limited to that product.

The product tab you pick when creating or editing a category on the Doc Categories page is just for your own organization, deciding which tab you’ll find it under later. It doesn’t restrict which product’s docs can actually use that category. If you want a category to also show up under a second product’s tab for easier access, use + Add existing on that product’s tab rather than creating a duplicate category, see The Doc Categories Page.

About the parent category option#

WordPress lets you set a parent for a category, since the taxonomy supports it. WP Super Docs doesn’t currently use this relationship anywhere on the frontend. Categories are always displayed as a flat list, whether or not you’ve set a parent, so there’s no need to organize categories hierarchically for this plugin’s purposes.

Assigning docs to a category#

Check a category in the Doc Categories panel while editing a doc, the same way you assign a product. See Writing Your First Doc for details.

Docs with no category#

If a doc has no category assigned, it’s grouped into a fallback bucket in navigation and on category cards, labeled “General.” This isn’t a real category you can edit; its URL segment is always uncategorized (for example /docs/main/uncategorized/some-doc/). It’s best to assign a real category to every doc rather than relying on this fallback.

Deleting a category#

On the Doc Categories page, deletion is blocked if the category has any docs assigned to it, you’ll see how many need reassigning first, rather than being allowed to delete it outright. Once every doc has been moved to a different category, delete removes the category term itself.

Category order#

Go to the Doc Categories page, drag categories to reorder them within a product tab, and click Save order. This order is authoritative on the actual docs site: it controls both the sidebar navigation and the “Browse by category” card grid on product pages, applied at the end regardless of whether that product’s navigation is on auto mode or has a manual override (see Auto-Generated Navigation vs. Manual Override). If you haven’t set an order here, categories fall back to sorting by name.

Categories and Claude#

If Claude is connected with an Administrator account (see Connecting Claude to Your Docs (MCP)), it can:

  • Create a category for a product, with its name, description, icon, sidebar position, parent and SEO title and description. To use an existing category under another product, Claude adds the existing one instead of making a duplicate.
  • Edit a category: its name, description, SEO title and description, icon and sidebar position. Its slug, and so its address, never changes.
  • Change the sidebar order of categories and of the docs in them.
  • Set its share image.

Try: “Write descriptions and SEO descriptions for every category in Lumen Booking.” On a site with WPML or Polylang, Claude can also create a category as the translation of an existing one.

Category names, descriptions and the sidebar order are already on your site for visitors, so Claude can only change them when your site lets Claude publish, or when changes to published docs go live right away. Creating a new category is always allowed for an Administrator.

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