FAQ Blocks with Schema for Gutenberg

What the blocks do

1) FAQs (container block)

The FAQs block is the wrapper that controls the overall FAQ section:

• Column layout (1–4 columns)
• Title tag selection for FAQ item titles (H3, H4, Span, Strong)
• Optional FAQ schema markup toggle (FAQPage)
• Automatically tracks the number of FAQ items and calculates a column break helper value for frontend layouts

When you change schema or heading settings in the container, the block automatically syncs those settings to all child FAQ items.

2) FAQ (item block)

Each FAQ block represents a single question + answer:

• Editable question title (RichText)
• Answer content built with InnerBlocks (you can add any blocks inside)
• Optional image per FAQ item (MediaUpload) with a quick remove button
• Editor productivity controls:
  • Copy item (duplicates the current FAQ block)
  • Delete item

Schema.org FAQ support (optional)

When schema is enabled in the container:

• the wrapper outputs FAQPage markup
• each item is rendered as a Question with an acceptedAnswer
• question title is mapped to the schema “name”
• answer content is mapped to the schema “text”

Schema is fully optional: turning it off removes schema attributes from output.

Layout and styling

Both blocks support native Gutenberg design tools:

• alignment (wide/full)
• colors (background/text/gradients)
• typography (font size, line height, letter spacing)
• spacing (padding/margin)
• anchors

This keeps styling consistent with your theme and avoids hardcoded design decisions.