The Doc Categories Page
Category management has its own dedicated admin page now, replacing the standard WordPress taxonomy screen, the same shift the Products page brought to product management (see The Products Page).
Where to find it#
Go to WP Super Docs → Doc Categories.

Layout#
Product tabs run across the top of the page; click one to load its categories below. Each category appears as a row showing its name, slug, doc count, and badges for OpenAPI, Internal only, and No sitemap, whichever apply.
Creating a category#
Click + New category, fill in a Name and optional Description, and confirm which product tab it belongs to. The slug is generated from the name automatically. This covers the basics; for everything else (slug, parent, icon), use Edit afterward.

Adding an existing category to another product#
Since categories are shared across products rather than locked to one (see the note below), you don’t need to create a duplicate category just to also use one on a different product’s tab. Click + Add existing, next to + New category in the toolbar, pick a category from the dropdown (it only lists categories not already shown on the current product tab), and click Add to product.

This adds the category to the current product’s tab without removing it from any product it’s already associated with, it’s purely additive. A note in the form itself explains this shared-category behavior.
Editing a category#
Click Edit on a category’s row. This opens WordPress’s standard category edit screen in a new tab, with every field available there: name, slug, parent category, description, and icon. The Doc Categories page itself doesn’t duplicate this into an inline panel, it links straight to the real edit screen instead.
OpenAPI, without leaving the page#
If OpenAPI is enabled (see OpenAPI Integration (Beta)), an OpenAPI button appears on every row. Click it to expand an inline panel with:
- The spec URL field, and a Save URL button.
- A Sync now button, which runs a sync for just this category and shows the result inline, including a link to the first generated doc.
This is the only field managed inline on this page; everything else routes through the Edit link’s new tab.
About the Product tab(s) a category sits under#
Choosing a product when creating a category decides which tab you’ll find it under here, it’s for your own organization while managing categories, and doesn’t restrict the category technically: the underlying category is still the same shared taxonomy described in Tags vs. Categories, and a doc in a different product can use it even if you never associate it with that product’s tab here.
A category can genuinely appear under more than one product’s tab at once, that’s exactly what + Add existing (above) is for, adding it to a second tab without removing it from the first.
Reordering categories#
Drag a category row to reorder it within its product tab, then click Save order (always visible in the toolbar) to persist it, reordering doesn’t save automatically as you drag.
Unlike earlier versions of this page, this order is now authoritative on the actual docs site: both the sidebar navigation and the “Browse by category” card grid on product pages use it. This order applies at the very end of how navigation is built, so it takes effect whether that product’s navigation is otherwise on auto mode or has a manual override configured (see Auto-Generated Navigation vs. Manual Override). If you’re relying on a specific category order for your readers, set it here, it now overrides whatever the auto or manual nav logic would have produced on its own.
Deleting a category#
Delete is blocked if the category has any docs assigned to it, you’ll see how many need to be reassigned first rather than a generic error. Once nothing is assigned to it, delete removes the category the same as before.
What this replaced#
Categories used to be managed through WordPress’s standard taxonomy screen. That screen is now hidden from the admin menu in favor of this page (the underlying screen itself is what the Edit link still opens, in a new tab).
Was this helpful?
Thanks for your feedback!
✓ Feedback received. Thank you!