FAQ

Present FAQs that are user-friendly and highly crawlable.

Usage

The FAQ block is a container for FAQ Card children β€” one per question. Use it to display frequently asked questions with answers that expand or stay visible depending on layout.

Answers work best as text (paragraphs and lists), but each card supports many nested blocks β€” headings, images, buttons, columns, forms, and more. Use richer blocks sparingly so accordion behavior and SEO stay clean.

Schema markup

FAQ output includes Schema.org Question and Answer structured data on each card. Content you add here can be eligible for rich results in search engines.

Parent and child blocks

Select the FAQ parent to change style, layout, and question typography for all cards. Select an FAQ Card child to edit that question's header, answer content, and optional header background image.

Use Add FAQ below the last card to insert more questions. Select the parent via the block toolbar breadcrumb, parent button, or List View when a child is active.

Style (parent)

Choose a visual preset for the whole FAQ (parent must be selected):

  • Outlined β€” bordered cards with spacing (default)
  • Cards β€” filled card backgrounds
  • Compact β€” dense rows with subtle dividers
  • Separator β€” flush list with separators between items
  • Naked β€” minimal chrome, no card background

All questions appear expanded in the editor for easier editing; front-end behavior follows the Layout setting.

Layout (parent)

  • Accordion (default) β€” answers hidden until the visitor clicks the question; click again to collapse
  • Static β€” all answers visible on the page without interaction

Header Tag and Header Style (parent)

  • Header Tag β€” semantic HTML tag for questions (h1–h6 or p) for SEO structure
  • Header Style β€” visual typography preset from your Customizer (can differ from the tag β€” e.g. h4 tag styled as h2)

FAQ Card settings (child)

Edit the question inline in the card header. Add answer content in the area below β€” paragraphs by default, or insert other allowed blocks.

Optional child sidebar settings:

  • Background β€” header image behind the question (with reverse print for legibility)
  • Image Focal Point β€” adjust crop when a background image is set

Block width

FAQ supports Wide and Full alignment from the block toolbar.

Tips

  • Prefer Accordion for long FAQ lists; use Static when every answer should be scannable without clicks.
  • Keep Header Tag hierarchy consistent with the rest of the page (often h3 or h4).
  • Use header background images for visual FAQs; skip them when clarity and speed matter most.
  • Stick to paragraphs and lists in answers when possible β€” nested layout blocks can make accordion UX harder to follow.

Screenshots

Front-end

  • Same accordion layout with several answers expanded at once.
  • Cards style with Static layout β€” each question and answer shown in its own card.

Editor

  • FAQ parent settings β€” Style, Layout, Header Tag, and Header Style.
  • FAQ Card child selected β€” optional background image for an individual question.

Settings

Settings

Style setting in the block editor sidebar
Style

Visual preset for all FAQ cards β€” Outlined (bordered), Cards (filled), Compact, Separator (dividers only), or Naked (minimal). Select the parent FAQ block to change this.

  • Outlineddefault
  • Cards
  • Compact
  • Separator
  • Naked
Layout setting in the block editor sidebar
Layout

Accordion hides answers until clicked (default on the front end). Static shows all answers expanded. Editor always shows answers open for editing.

  • Static
  • Accordiandefault
Header Tag setting in the block editor sidebar
Header Tag

Semantic HTML element for each question (h1–h6 or p). Important for page outline and FAQ schema.

  • h1
  • h2
  • h3
  • h4default
  • h5
  • h6
  • p
Header Style setting in the block editor sidebar
Header Style

Customizer typography preset for question text. Independent of Header Tag β€” e.g. use an h4 tag with h2 visual styling.

  • <h1>
  • <h2>
  • <h3>
  • <h4>default
  • <h5>
  • <h6>
  • <p>
  • <strong>