Docs
← Back to site

Product GroupsUpdated

2 min readUpdated November 21, 2026

If you have more than a few products, grouping them into named sections makes the /docs/ landing page and product switcher much easier to scan than one long, flat list.

Creating a group#

Go to WP Super Docs → Products and click + New group. Give it a name, then set:

  • Style: Cards or Compact list (see below).
  • Columns: 2, 3, or 4 per row on desktop.
The Products page with products in groups, each group with its style and column settings.

Drag products from anywhere on the page into the group to assign them, and click Save layout when you’re done. See The Products Page for the full drag-and-drop mechanics.

Ungrouped products#

Products with no group assigned always render first on the landing page, above every named group. This means you don’t have to group everything, you can group only the products that benefit from it and leave the rest ungrouped at the top.

Cards vs. Compact list#

Cards is the default: an image, name, and description for each product, arranged in a grid.

Compact list shows just the product name and an arrow, arranged in a grid matching your column count, a much denser option for a group with many products where a full card per item would take up too much space.

How the column count behaves#

The column count you set is a maximum, not a fixed count. A group with only 2 products set to 3 columns renders as 2 columns, not 3 columns with an empty gap. On tablet screens, groups automatically drop to 2 columns regardless of their desktop setting; on mobile, they drop to 1.

Empty groups#

A named group with no products currently assigned to it doesn’t appear on the landing page at all, rather than showing as an empty section with just a heading.

The product switcher modal#

The switcher modal (see The Product Switcher) mirrors your groups: each group appears as its own labeled section within the modal, rendered in that group’s own style, Cards or Compact list, matching what you’ve set for it. Readers get the same organized view when jumping between products from any doc page, not just from the landing page itself.

The Choose a product window with products listed under their group names.

With Claude#

With Claude connected, you can ask it to move a product into a group, or take it out of one: “Put Lumen CLI in the Developer Tools group.” A product Claude moves goes to the end of its new group. This needs an Administrator’s account, and your site must let Claude publish, since the docs homepage changes right away. Groups themselves (their name, style and columns) are created and arranged on the Products page.

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