Skip to content

Taxonomies

Overview

Converto uses four taxonomies to structure product data. They're not interchangeable - each plays a specific role:

TaxonomyPurposeExample terms
CategoryThe vertical or product type. One per product.Web Hosting, Smartwatches, Mobile Plans
Rating CategoryDimensions reviewers score a product on.Performance, Customer Support, Value
FeatureYes/no/conditional capabilities.Free SSL, GPS, Unlimited Data
SpecificationText-valued attributes.Storage, Battery Life, Data Allowance

The killer feature is applicable_categories scoping - every rating, feature, and spec term can be limited to one or more categories, so the product editor only shows terms relevant to the category you've selected.

Category

The primary taxonomy. Each product belongs to exactly one category.

Find it under Products → Categories.

What categories drive:

  • URLs - products live at /{category-slug}/{product-slug}/.
  • Archive pages - /category-slug/ lists every product in that category.
  • Breadcrumbs - Home › Web Hosting › Bluehost.
  • Related products - same-category products in the sidebar.
  • Taxonomy scoping - see below.

One category per product

Even though the taxonomy supports multiple, the URL structure and archive logic assume one. Pick the most specific category that fits.

Category settings

When editing a category, Converto adds:

  • Hero settings - title, intro, hero image (used at the top of the archive page).
  • Archive page - optional WP page assigned to this category. If set, that page is shown instead of the default archive layout. Useful for hand-built Best Web Hosting Providers in 2026 landing pages.
  • Schema type - how this category renders in JSON-LD (defaults to Product).

Rating Category

Dimensions you score products on.

Find it under Products → Rating Categories.

A rating category is just a label + a description - there's no numeric value at the term level. The score is set per product, in the product editor's Ratings tab.

Typical setup:

  • Performance
  • Customer Support
  • Pricing
  • Ease of Use
  • Value for Money

5 is a sweet spot. Fewer feels shallow; more clutters the rating table.

Feature

Yes/no/conditional capabilities.

Find it under Products → Features.

A feature is something the product either has or doesn't (or has with caveats). On the product editor, each feature gets a {is_available, editor_note} pair:

  • Yes → ✓ checkmark
  • No → ✗ X
  • Conditional → - dash (with the editor note shown alongside)

Yes/no, not levels

If you find yourself writing "Has good support" as a feature, that's actually a rating category (where you score support 1–5). Features are binary capabilities - "24/7 live chat support" is a feature; "Customer support quality" is a rating category.

Specification

Text-valued attributes.

Find it under Products → Specifications.

A specification is a fact with a value: Storage: 100GB, Battery: 14 days, Data: Unlimited. On the product editor, each spec is a {specification, value} row.

Values are free text - there's no unit field. Bake the unit into the value: 100 GB not 100.

Applicable categories scoping

This is the feature that keeps your product editor sane.

Every rating category, feature, and specification term has an Applicable Categories field on its edit screen:

When you select a category there, that term only appears in the product editor's dropdowns when the product is in one of those categories. A spec like Battery Life shouldn't show up in the Web Hosting product editor; an applicable_categories of Smartwatches ensures it doesn't.

If you leave applicable_categories empty, the term appears for every category (rare - usually a sign you haven't finished setting up).

Example: setting up "Web Hosting"

  1. Create the Category Web Hosting.
  2. Create Rating Categories: Performance, Uptime, Support, Pricing, Ease of Use. On each, set applicable_categories = Web Hosting.
  3. Create Features: Free SSL, Daily Backups, One-Click Installer. Same - applicable_categories = Web Hosting.
  4. Create Specifications: Storage, Bandwidth, Server Locations. Same.
  5. Now create a product, set its category to Web Hosting - only those rating/feature/spec terms appear in the dropdowns.

If you're going to support multiple categories, repeat for each, but scope each term properly. Storage might make sense for both Web Hosting and Cloud Backup; tick both in applicable_categories.

The demo importer does this for you

If you ran the Demo Importer, it automatically links every seeded rating/feature/spec term to the seeded category. You only need to think about this when you're hand-creating taxonomy structures.

Re-ordering terms

Drag-and-drop ordering is enabled on every taxonomy. The order controls:

  • Features in the product editor and Features block - top-listed features appear first in comparison tables.
  • Rating Categories in the Ratings block.
  • Specifications in the Specifications block.
  • Categories in nav menus pulling category items.

Drag the rows on the taxonomy list screen. Order is saved automatically.

Term icons

Each taxonomy supports an optional icon field (Iconify slug):

  • Used in the Features block as the bullet for each feature.
  • Used in Rating block alongside each rating category.
  • Used in Specifications block as the row icon.

Find slugs at icones.js.org. Material Symbols, MDI, Remix, and Tabler are bundled.

What's next

  • Use the Demo Importer to seed a starter taxonomy structure for one of the included verticals.
  • Once your taxonomies are set up, start creating products.
  • Surface taxonomy-driven views in your page builds via Blocks (Comparison Table, Features, Ratings).

KrafterSuite Documentation