You can add FAQ schema in WordPress for free with the Accordions (UB) block in Ultimate Blocks. Add each question as an accordion panel, turn on Enable FAQ Schema, and the block outputs FAQPage structured data (JSON-LD) for you. You don’t need to write any code or install a separate schema plugin.

What you need #

• The free Ultimate Blocks plugin, installed and active. No Pro license is needed.
• A post or page with real questions and answers your readers ask.

What FAQ schema does #

FAQ schema is structured data in the schema.org FAQPage format. It tells search engines and AI tools which text on your page is a question and which text is its answer. This makes your content easier for machines to read and quote correctly.

Good to know: Since 2023, Google shows FAQ rich results (the expandable questions under a search result) mainly for well-known government and health websites. Most sites will not see that visual feature, even with valid markup. The schema is still valid and still describes your content clearly.

How to add FAQ schema with the Accordions (UB) block #

1. Open the post or page in the WordPress block editor.
2. Click the + (Block Inserter) button, search for Accordions (UB) and click the block to add it.
3. Click the first panel title and type your question. Then click the panel content and type the answer.
4. To add more questions, select a panel and use Insert New Toggle Below (or Insert New Toggle Above). Repeat for each question.
5. Select the whole Accordions (UB) block, not a single panel. You can click Select parent block in the block toolbar or pick it in the List View.
6. In the Settings tab of the block sidebar, open the FAQ Schema panel and turn on Enable FAQ Schema.
7. Click Update or Publish.

How Ultimate Blocks builds the schema #

• Each panel title becomes a Question, and the panel content becomes its Answer.
• Panels with an empty title or an empty answer are skipped, so they don’t create invalid items.
• If one page has more than one Accordions (UB) block with FAQ schema turned on, Ultimate Blocks merges all the questions into a single FAQPage. You won’t get duplicate FAQPage markup from the plugin.
• The schema is added on single posts and pages, as a JSON-LD script near the end of the page.

How to test your FAQ schema #

Always test after you publish. Use Google’s Rich Results Test:

1. Open your published post and copy its URL.
2. Go to Google’s Rich Results Test.
3. Paste the URL and click Test URL.
4. When the test finishes, look for FAQ in the list of detected items. Click it to see every question and answer Google found, and check for errors or warnings.

You can also paste the URL into the Schema Markup Validator. It checks that the markup is valid schema.org data, whether or not Google shows a rich result for it.

Good practice for FAQ schema #

• One FAQ section per page: keep your questions in one place. If an SEO plugin or another block also adds FAQ schema to the same page, turn one of them off so the same questions are not marked up twice.
• Only mark up visible content: every question and answer in the schema must also appear on the page. The Accordions (UB) block handles this, because the schema is built from the panels readers see. Collapsed panels are fine, since readers can open them.
• Write real questions: use the questions people actually ask you or type into search. Keep answers short and complete, usually 1 to 3 sentences.
• No ads or sales pitches in answers: answer the question. Search engines may ignore FAQ markup used for advertising.
• Use it for one-answer questions: FAQ schema is for questions you answer yourself. Forums or pages where users post several answers to one question need different markup (QAPage).
• Don’t copy the same FAQ to every page: write questions that fit the page they are on.

Frequently asked questions #

Related docs #

• Accordions (UB) block
• How to add a search box to accordions (Pro)
• How to add review schema and star ratings
• How To block (HowTo schema)
• Table of Contents block