Organizing docs with Topics and Products

HelpWP uses two taxonomies to group content:

• Topics (helpwp_topic): hierarchical, exclusive to docs. Use Topics to mirror the chapter / section structure of your knowledge base.
• Products (helpwp_product): flat, shared between docs and tickets. Use Products when you have multiple product lines on one site so a single article or ticket can be tagged with the product it relates to.

Topics

1. Go to HelpWP -> Topics.
2. Click Add New Topic.
3. Give it a name (e.g. Getting Started, Billing, API).
4. Optionally pick a parent topic to nest it under another.
5. Save.

Hierarchical topics let you build URL paths like /docs/billing/refunds/ if your permalink structure includes the topic slug.

Products

1. Go to HelpWP -> Products.
2. Click Add New Product.
3. Give it a name (e.g. HelpWP Pro, EasyDocs).
4. Save.

Products are flat: there is no parent / child hierarchy. They can be assigned to:

• Docs (in the doc edit screen)
• Tickets (in the ticket edit screen and on the new-ticket form)

The shared product term gives both modules a single label they can use to filter content.

Why this matters for the URL

If your docs permalink structure is docs/<topic>/doc-slug, every doc must have at least one topic. If it has more than one, the first assigned topic is used in the URL. Same rule applies to product-prefixed structures.

Filtering the docs archive by product

The

[helpwp_docs product="helpwp-pro"]

It renders only the docs tagged with that product term, grouped by topic.