FAQ Widget for Magento 2 - Rich Snippets

The Rich Snippets Suite includes a FAQ widget that lets you add FAQ sections to any CMS page or block. The widget automatically generates FAQPage structured data (schema.org JSON-LD) so Google can display your FAQ as a rich result. You can choose to show the FAQ visually on the page as an accordion, or keep it hidden and only output the structured data. Both Luma and Hyva themes are supported with dedicated accordion templates.

How It Works

The FAQ widget stores question/answer pairs and outputs them in two ways:

1. JSON-LD structured data - Always included. Google uses this to display FAQ rich results in search.
2. Visual accordion - Optional. Renders the FAQ as an interactive accordion on the page.

Adding the Widget

Via CMS Page/Block Editor

Widget Options

FAQ Items

FAQ Theme

Display FAQ on Frontend

Structured Data Output

Regardless of the display setting, the widget always outputs FAQPage schema.org markup as JSON-LD. This is what Google reads to create rich results.

Example output:

{
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
        {
            "@type": "Question",
            "name": "What is your return policy?",
            "acceptedAnswer": {
                "@type": "Answer",
                "text": "You can return items within 30 days of purchase."
            }
        },
        {
            "@type": "Question",
            "name": "Do you offer free shipping?",
            "acceptedAnswer": {
                "@type": "Answer",
                "text": "Yes, free shipping on orders over 50 euros."
            }
        }
    ]
}

Validating Your FAQ Rich Results

After adding the widget, verify the structured data is correct:

1. Save and publish the page
2. Open Google's Rich Results Test
3. Enter the page URL
4. Check that "FAQ" appears as a detected rich result type

Tip: It can take a few days to weeks before Google picks up the structured data and displays it in search results.

Need More Help?

Documentation:

• All Help Articles - Complete documentation overview

Support:

• Contact Support - Get help from our team