Blocks

Overview

Blocks are the building blocks of every Converto page. They're added via the ACF Flexible Content field on Pages, Posts and Products - pick a block type from the + New Block dropdown, fill in its fields, drag to reorder.

Blocks come in two flavours:

• Universal blocks - work on any page, post, or product. Either self-contained (Content, FAQ, Gallery) or configured with a set of products you pick or auto-query (Product Reviews, Comparison Table, Showcase, Grid).
• Product blocks - meant for the product post type. They auto-bind to the host product's data (ratings, pros/cons, features, specs, pricing, verdict). Outside a product page they have no data to render.

Each tier is gated separately. The free tier ships the universal essentials; the advanced tier (active licence) unlocks every product block and every multi-product layout.

Universal blocks

Block	Tier	Use case
Content	Free	Free-form WYSIWYG with headings, lists, images, embeds.
Gallery	Free	Image gallery with lightbox.
FAQ	Free	Collapsible Q&A items with FAQPage JSON-LD.
Product Reviews	Advanced	Stacked product cards - one row per product with rating + CTA.
Comparison Table	Advanced	Side-by-side product comparison with sticky first column.
Showcase	Advanced	Magazine-style featured-product strip.
Grid	Advanced	Card grid pulled from a post type, product category, tag, or author.

Content

The general-purpose WYSIWYG block. Use it for:

• Long-form review prose between data-heavy blocks.
• Intros, verdicts, supporting context.
• Anything that doesn't fit a structured block.

Settings:

• Title + Subtitle + Title Level - optional heading above the content.
• Content - full WP editor (headings, links, images, embeds, blockquotes).

Don't overuse it

If you find yourself building a comparison inside a Content block via tables, switch to a Comparison Table block

• it'll handle responsive scrolling, sticky columns, and structured data for you.

Gallery

Image gallery with lightbox.

Settings:

• Title - optional H2.
• Images - multi-select from media library.

FAQ

Collapsible Q&A items.

Settings:

• Title - optional H2.
• Items - repeater of {question, answer} rows.

JSON-LD FAQPage schema is applied automatically. See SEO & Schema.

Product Reviews

Stacked card layout - one card per product, with rating, intro, key features and CTA. The block the demo importer uses on the seeded homepage.

Settings:

• Title + Subtitle + Title Level.
• Style - Style 1 (full editorial cards), Style 2 (compact leaderboard), Style 3 (full reviews).
• Use custom setup - off picks specific products by hand; on auto-queries by category + sort.
• Products - the post picker (when Use custom setup is off).
• Custom setup - category, show-only limit, order-by (rating / date / title) when Use custom setup is on.
• Display rows - up to 6 feature, specification, or rating_category terms surfaced as detail rows on each card.

Comparison Table

The flagship block. Side-by-side product comparison with:

• Sticky first column (the row labels) when scrolling horizontally.
• Floating scroll buttons on desktop, native swipe on mobile.
• Winner highlighting on rating rows.
• True/false rows render as ✓ / ✗ icons.

Settings:

• Title + Subtitle + Title Level.
• Style - Style 1 (full grid).
• Use custom setup - off picks specific products; on auto-queries by category + sort.
• Products - post picker (when Use custom setup is off).
• Custom setup - category, show-only limit, order-by, exclude-products (when Use custom setup is on).
• Display rows - feature / specification / rating_category terms to render as rows. Only category-scoped terms show up in the picker, so you can't accidentally add Battery Life to a comparison of web hosts.

Showcase

Magazine-style strip for highlighting a hand-picked set of products with featured imagery and short copy.

Settings:

• Title + Subtitle + Title Level.
• Style - Style 1 / Style 2.
• Products - post picker (manual selection).

Grid

Card grid that pulls posts from a source you configure. Useful for category landing pages, author archives, related content strips, and the homepage hero blocks.

Settings:

• Title + Subtitle + Title Level.
• Mode - one of:
  • By post type - pick a post type (product, page, blog post, author) and an optional set of items.
  • By product category - all products in a chosen category.
  • By tag - filter by converto_tag terms with any / all matching.
  • By author - all posts assigned to a chosen author CPT.
• Style - Style 1.
• Columns + Limit + Order by - layout and query controls.

Product blocks

These blocks are designed to live inside a product page. They auto-pull their content from the host product's fields, so once you've filled in the product's Ratings / Pros & Cons / Features / Specifications / Pricing / Author tabs, dropping the matching block onto the page is enough - no per-block configuration needed beyond the standard title / subtitle / TOC fields.

Pros & Cons is the one exception: it can run in "manual" mode on any page by filling in its own lists.

Block	Tier	What it pulls
Pros & Cons	Free	The Pros / Cons repeaters (or its own lists when Use product data is off).
Ratings	Advanced	Global rating + per-rating-category scores with editor notes.
Features	Advanced	The feature repeater - yes / no / conditional icons.
Specifications	Advanced	The specification repeater - key/value rows.
Pricing	Advanced	Pricing tiers or retailer deal rows, mirroring the product's Pricing Mode.
Verdict	Advanced	The verdict copy + author byline + last-updated date.

Pros & Cons

Two-column pros/cons list with checkmark / X icons.

Inside a product page: flip Use product data on and the block auto-pulls from the product's Pros & Cons tab.

Outside a product page (or with Use product data off): fill in the block's own Pros / Cons repeaters - this makes it usable on regular pages too.

Settings:

• Title + Subtitle + Title Level.
• Use product data - toggle the auto-bind behaviour.
• Pros title / Cons title - override the column headings.
• Pros / Cons - manual repeaters (used when Use product data is off).

Ratings

Renders the per-rating-category scorecard.

Settings:

• Title + Subtitle + Title Level.
• Style - Style 1 (editorial scorecard) with the global score on the left and per-category rows on the right.
• Custom text - optional copy shown beneath the global score.

Features

Yes/no/conditional feature list with icons.

Settings:

• Title + Subtitle + Title Level.
• Style - Style 1.
• Heading - optional headline above the feature rows.

Specifications

Text-valued attribute table.

Settings:

• Title + Subtitle + Title Level.
• Style - Style 1.

Pricing

Renders the product's pricing tiers or retailer deal rows, mirroring whatever Pricing Mode is set on the product.

Settings:

• Title + Subtitle + Title Level.
• Mode - pricing (subscription tiers) or deals (retailer rows). Defaults to whatever the product is configured for.
• Pricing style - Style 1 (cards) / Style 2 (compact).
• Deals style - Style 1 / Style 2 for retailer-row layouts.

Verdict

Author quote / closing summary with the byline and date.

Settings:

• Title + Subtitle + Title Level.
• Style - Style 1.
• Eyebrow label - small uppercase line above the verdict (e.g. The verdict).

Add product blocks - one-click preset

On the product post type, an Add product blocks button appears next to + New Block. It opens a preset modal that lets you add the full product page stack (Ratings, Pros & Cons, Features, Specifications, Pricing, Verdict) in one go.

Block settings shared across every block

Every block carries a Block Settings tab in addition to its own fields:

• Title + Title Level (H2-H6 / span) + Subtitle.
• TOC Title - override the label shown for this block in the page Table of Contents (falls back to the title).
• Exclude from TOC - skip this block when building the page TOC.
• Content Before + Content After - WYSIWYG fields rendered immediately before / after the block.

The TOC is built automatically from block titles.

Adding blocks to a page

1. Edit a Page, Post or Product.
2. Scroll to the Blocks Section.
3. Click + New Block and pick a layout.
4. Fill in the block fields under the Block Data tab and the universal options under Block Settings.
5. Drag the handle on the left to reorder. Click the row title to collapse.

What's next

• See Hero for hero-section configuration (which sits above the block stack).
• See SEO & Schema for what blocks emit in JSON-LD.