How to Add FAQ Schema in WordPress (and Is It Still Worth It?)

To add FAQ schema in WordPress, use an FAQ block from your SEO or schema plugin (which displays the questions and adds FAQPage schema automatically), or output FAQPage JSON-LD with code. Only mark up questions and answers that are visible on the page.

Google now shows FAQ rich results mainly for authoritative government and health sites, so treat FAQ schema as a clarity signal rather than a guaranteed listing upgrade.

A few years ago, adding FAQ schema was an easy win: your listing in Google grew a set of expandable questions and pushed competitors further down the page.

Then, in August 2023, Google limited FAQ rich results to well-known, authoritative government and health websites. For most sites, the expanded FAQs disappeared overnight.

So is FAQ schema dead? Not quite.

It no longer earns that visual boost in Google for most sites, but well-structured questions and answers still help search engines, voice assistants and AI tools understand and quote your content.

And the FAQ section itself is still one of the most useful things you can add to a service page.

This guide covers when FAQ schema is worth adding, three ways to do it in WordPress, and how to write FAQs that help readers and rankings.

FoundHint Local SEO WordPress

Optimize your Google Business Profile without leaving WordPress

Connect your GBP profile, compare it with your website and fix the gaps FoundHint finds.

• Business Profile audit and optimization
• Google Post scheduling
• Review management and replies
• Local rank tracking on a map grid

Get FoundHint Free

Is FAQ Schema Still Worth Adding?

Verdict: keep writing FAQ sections on service, product and guide pages because they answer real objections and long-tail searches. Adding FAQPage schema to them is a low-cost bonus, not a ranking tactic.

Three Ways to Add FAQ Schema in WordPress

Method 1: An FAQ block from your SEO plugin

Yoast, Rank Math and AIOSEO each include an FAQ block.

Add it in the block editor, type each question and answer, and the plugin displays them and outputs FAQPage schema automatically.

This is the easiest option and keeps the schema in sync with the visible text.

Method 2: A schema plugin

Dedicated schema plugins let you add FAQPage schema to a page from a form, or map it to existing content. Make sure the questions you enter also appear on the page.

Method 3: Code that reads the core Details block

Since WordPress 6.3, the core Details block creates an expandable question with an answer inside, with no plugin. This snippet (in a site-specific plugin or child theme) turns every top-level Details block on a page into FAQPage schema:

add_action( 'wp_head', function () {
    if ( ! is_singular() ) {
        return;
    }

    $post   = get_post( get_queried_object_id() );
    $blocks = parse_blocks( $post->post_content );
    $faqs   = array();

    foreach ( $blocks as $block ) {
        if ( 'core/details' !== $block['blockName'] || empty( $block['attrs']['summary'] ) ) {
            continue;
        }

        $answer = '';
        foreach ( $block['innerBlocks'] as $inner ) {
            $answer .= render_block( $inner );
        }
        $answer = trim( wp_strip_all_tags( $answer ) );

        if ( $answer ) {
            $faqs[] = array(
                '@type'          => 'Question',
                'name'           => wp_strip_all_tags( $block['attrs']['summary'] ),
                'acceptedAnswer' => array(
                    '@type' => 'Answer',
                    'text'  => $answer,
                ),
            );
        }
    }

    if ( count( $faqs ) < 2 ) {
        return;
    }

    echo '<script type="application/ld+json">' . wp_json_encode( array(
        '@context'   => 'https://schema.org',
        '@type'      => 'FAQPage',
        'mainEntity' => $faqs,
    ) ) . "</script>\n";
} );

To use it: add a Details block, type the question as its summary, and the answer inside. Only Details blocks placed directly in the page (not inside groups or columns) are read.

If you also use an SEO plugin’s FAQ block on the same page, use one or the other, not both. For more code patterns, see How to Add Custom Schema in WordPress Without Plugins.

How to Write FAQs That Actually Help?

• Use real questions. Pull them from sales calls, customer emails, Google’s People Also Ask, and your Search Console queries.
• Answer in the first sentence. Lead with the direct answer, then add a sentence or two of detail. That’s also the format AI tools quote most easily.
• Keep it to 4 to 8 questions per page, each specific to that page.
• Don’t repeat the same FAQs on every page. Identical blocks across dozens of pages add nothing and look templated.
• Keep answers current. Prices, timelines and policies in FAQs go stale fast.
• No advertising in answers. Google’s guidelines exclude FAQ markup used for promotional content.

FAQs for Local Businesses

For local service pages, FAQs are some of the hardest-working content you can add.

People ask voice assistants and AI tools questions like “Does a plumber in Austin charge a call-out fee?” or “Is there parking at the dentist on Congress Ave?” Clear, local answers on your pages give those tools something accurate to quote.

Good local FAQ topics: service area and travel fees, emergency or weekend availability, parking and access, insurance and payment options, how long a typical job takes, and what to do before the appointment.

Use the same questions to fill your Google Business Profile’s Q&A where available, and keep the answers consistent.

Pair FAQs with accurate LocalBusiness schema and location pages, which FoundHint generates for every location, so the facts AI assistants pick up about your business are consistent everywhere.

FoundHint Local SEO WordPress

Optimize your Google Business Profile without leaving WordPress

Connect your GBP profile, compare it with your website and fix the gaps FoundHint finds.

• Business Profile audit and optimization
• Google Post scheduling
• Review management and replies
• Local rank tracking on a map grid

Get FoundHint Free

Read How to Rank for Near Me Searches for more on question-based local searches.

Frequently Asked Questions