Products

Overview

The Product CPT is the core content type in Converto. Each product represents one item being reviewed - a host, a SaaS tool, a smartwatch, a kitchen appliance. A product page bundles together a hero with an affiliate CTA, structured ratings, features, specifications, pros/cons, pricing or retailer deals, and a stack of editor blocks.

Before creating products, set up your taxonomies - categories, rating categories, features, and specifications. Without them the product editor is mostly empty dropdowns.

Creating a new product

Products → Add New in the WP admin sidebar.

The product editor is organised into ACF tabs along the top:

Tab	What lives here
General	Featured image, badge, category, label, short review, long-form review
Author	Author CPT assignment + verdict copy
Pros & Cons	Two repeaters - one positive item per row, one negative
Ratings	Global rating + per-rating-category scores with editor notes
Pricing / Deals	Mode switch + subscription tiers or retailer deal rows
Features	Yes/no/conditional capabilities pulled from the feature taxonomy
Specifications	Text-valued attributes pulled from the specification taxonomy
Tags	Cross-cutting tags surfaced on cards and the product page
Affiliate Links	One or more outbound destinations, each cloaked through a pretty-link redirect

Beneath the tabs there's a separate Hero field group (shared with pages/posts) for hero copy and imagery, and a Blocks Section for the flexible-content stack rendered below the hero.

Required at minimum: title, category, featured image, one affiliate link. Everything else can be filled in incrementally.

General tab

Field	What it does
Featured Image	The product logo / square mark. Used in cards, grids, comparison columns, and the sticky CTA. Recommended 400×400px @2x = 800×800px, transparent PNG.
Badge	Optional small badge image (e.g. Editor's Pick) overlaid on the featured image in cards, the comparison table and the showcase grid.
Category	The product's vertical. Drives breadcrumb, archive, and which rating/feature/spec terms are available - see Taxonomies for scoping.
Label	Short eyebrow line shown above the product name in cards and on the hero (e.g. Best for Beginners, Editor's Pick).
Short Review	1-2 sentence summary used in cards and meta descriptions. Capped at ~220 characters.
Review	Long-form WYSIWYG content - the body of the actual review. Surfaced through the Content block on the product page when configured to pull from product data.

Author tab

Field	What it does
Post Author	Pick a Converto Author CPT (not a WordPress user). Drives the byline, author card, and JSON-LD author schema. Leave empty to fall back to the global editorial byline (String Translations).
Author Verdict	Short closing quote from the reviewer, surfaced through the Verdict block on the product page.

Pros & Cons tab

Two repeaters: Pros and Cons. Each row is just a single text line. Lists render as a 2-column grid with checkmark / X icons.

When a Pros & Cons block is added to the product page stack with Use product data enabled, it auto-pulls these lists - no need to duplicate them inside the block.

Ratings tab

• Global Rating - single 0-5 score, displayed on the hero, in cards, in grids, and as a column header in comparison tables.
• Ratings - repeater of {rating_category, score, editor_note} rows. The category dropdown only shows rating_category terms scoped to this product's category (via applicable_categories).

The per-category scores feed the Ratings block on the product page and appear as the rating-row in Comparison Tables when this product is included.

Pricing / Deals tab

A single Pricing Mode switch controls which repeater is active:

Tiers mode

For subscription-style products (SaaS, VPNs, web hosts). A repeater of pricing tiers with:

• Tier Title - e.g. Starter, Pro, Enterprise.
• Tier Text - short positioning line (e.g. For individuals).
• Featured Tier - flips a highlight style on the card.
• Price + Original Price - the latter renders struck-through for a discount.
• Billing Period - monthly / yearly.
• Tier Affiliate Link - which of the product's affiliate links this tier's CTA points to.
• Tier CTA Label - override the default Visit button copy.
• Tier Features - bullet list rendered below the price.

Deals mode

For physical products (watches, electronics, gear). A repeater of retailer rows with:

• Retailer Name - e.g. Amazon, Best Buy.
• Retailer Logo - optional image rendered alongside the name.
• Featured Deal - highlights one retailer as the editor's pick.
• Price + Original Price - struck-through original for the discount badge.
• Deal Affiliate Link + CTA Label - which affiliate link this row points to.

Pricing data is consumed by the Pricing block on the product page (configured to render whichever mode the product is in) and by the Comparison Table block.

Features tab

A repeater of {feature, is_available, editor_note} rows. The feature dropdown only shows feature terms scoped to this product's category.

• is_available - yes / no / conditional. Maps to checkmark / X / dash icons in the Features block and comparison tables.
• editor_note - optional one-liner shown below the feature label.

Tip: order matters. The first 3-4 features render most prominently in comparison tables, so put the differentiators first.

Specifications tab

A repeater of {specification, value} rows. The specification dropdown is scoped the same way features are.

Values are free text - 100 GB SSD, Up to 50 Mbps, Aluminium / glass. No unit field; bake the unit into the value.

Tags tab

A multi-select for the converto_tag taxonomy. Tags are cross-cutting labels (e.g. New, On sale, Top pick) surfaced on product cards in the Grid block and on the product hero. Unlike categories, a product can have many tags.

Affiliate Links tab

A repeater of one or more outbound destinations. Each row carries:

• Affiliate Link - the destination URL.
• CTA Label - button copy (defaults to Visit).

The first row is treated as the product's primary CTA - it's what the hero button, sticky CTA bar and grid/comparison cards link out to. Additional rows let you wire different tiers / deal retailers to different destinations from the Pricing / Deals tab.

Pretty-link cloaking

Every outbound CTA is routed through /{prefix}/{product-slug}/ (default prefix is visit, configurable in General Settings). The redirect uses rel="nofollow sponsored noopener" and means:

• You can swap an affiliate link in one place and every CTA across the site updates.
• Your real affiliate URL never appears in HTML, which keeps click attribution clean.
• Unpublished products surface a graceful fallback instead of a broken link.

See Affiliate Links for the full mechanic.

Hero (separate field group)

The Hero section sits below the tabs as its own field group. It's shared with pages and posts, so behaviour matches the Hero reference - title overrides, title label, body copy, hero image, background image with overlay, sticky-CTA copy, and so on. Anything left empty falls back to global defaults configured in Layout settings.

Blocks Section

A flexible-content stack rendered below the product hero. Each layout is a self-contained block. The full reference lives at Blocks.

Several blocks are product-aware - when added to a product page they auto-bind to that product's data instead of asking you to re-enter it:

• Verdict - pulls the Author + Author Verdict from the Author tab.
• Ratings - pulls the global rating + per-rating-category scores from the Ratings tab.
• Pros & Cons - pulls the Pros / Cons repeaters when Use product data is enabled.
• Features - pulls the feature rows from the Features tab.
• Specifications - pulls the specification rows from the Specifications tab.
• Pricing - renders the tiers or deals from the Pricing / Deals tab, mode-aware.

Other blocks (Content, FAQ, Comparison Table, Showcase, Grid) take their own configuration.

Common product page stack

1. Verdict (auto-bound)
2. Content - long-form review intro
3. Ratings (auto-bound)
4. Pros & Cons (auto-bound)
5. Features (auto-bound)
6. Pricing (auto-bound)
7. Comparison Table - this product vs alternatives
8. FAQ - common questions

Saving & viewing

Hit Publish. The product appears at /{category-slug}/{product-slug}/ (e.g. /web-hosting/bluehost/).

If you get a 404, you forgot to save your permalinks once after activation - see Getting Started.

What's next

• Set up your Taxonomies before creating products.
• Configure the Hero defaults globally so every new product starts with sensible hero settings.
• Wire affiliate destinations via Affiliate Links.
• Browse the Blocks reference to see what's available for your product page stack.