Creating “FAQPage” Schema Markup Using the Schema App Editor

This short video demonstrates the basics of creating FAQPage markup. Read on for a detailed step-by-step tutorial with screenshots. 

Create a FAQPage data item

The first step is to create a FAQPage data item. All questions (and their answers) will be nested under this data item. In the Structured Data Editor, use the class tree to search for “FAQPage”. Once selected, click “Create”.

Assign the data item a name and a URL. We recommend assigning a name that is descriptive and clearly identifies the item you are creating. In our example, the name for our “FAQPage” is “Schema App Pricing FAQs”. Enter the URL of the page where this FAQ content exists. 

? Copy the URL from the address bar to avoid any typos or missing trailing slashes.

Once created, the page will refresh and the data item will be in Edit mode. You are required to have at least one Main Entity (a question) for the FAQ Page.

Create a Question data item

Type the first question in the "Main Entity" field, and click “Convert to Data Item”.

Next, you'll be prompted to add the URL of this new data item, as well as its schema.org "type".  Start by changing the "type" to “Question”. Once selected, the Editor automatically appends a "#Question" anchor tag to the end of the URL. Each Question data item requires a URL with a unique anchor tag (E.g. #Question1, #Question2, etc.) to differentiate it from other content on the page. The base URL should always reflect the page on the site where the FAQs reside.

Once you have the correct URL, anchor tag, and type, click “Create”.

Create an Answer Data Item

Now you need to create an Answer data item for the question. To do so, name the data item by pasting the question In the “Accepted Answer” field, followed by the word, "Answer".

Then click “Convert to Data Item” and a new embedded form will appear. Change the Type to "Answer", and verify that the URL includes an anchor tag with #Answer. Once the name, URL, and type fields are correct, click the orange “Create” button.

Another form will appear, prompting you to enter the text of the answer. Copy and paste the answer into the “Text” field and click the “Done” button. Your Answer data item is now complete! You can clearly see that you have a FAQPage (data item)  that includes a specific Question (embedded data item) with a specific Answer (embedded data item).

Click "Done" again to close this question form. You'll be taken back to the FAQPage form where you can add another Question data item to the "Main Entity" field. 

Repeat the Process

To get started on the next question, use the “+” symbol on the right-hand side of the page to add a new "Main Entity" field. Complete the above steps for each Question and Answer pair you want to mark up.

Check Your Work

When you save the data item, the Editor will alert you to any missing required or recommended fields. If this happens, either go back and fill them out or add content to the web page so that you can mark it up.

? You can only mark up content that is visible on a web page.

Once done, you have the option to generate the JSON-LD and test it with Google to ensure that you have captured all relevant information. The markup created in this tutorial generates the following error and warning free result in the SDTT.