What is structured data?
Structured data (in JSON-LD format) is markup that helps search engines accurately understand the meaning and purpose of your page content. Because JSON-LD is written separately from the page's HTML, it's easier to maintain.
Structured data you define may appear as rich results (rich snippets) on search engines like Google. Rich results support a wide variety of content types, including Articles, Product Reviews, FAQs, Job Postings, and more.
For more details, see the official Google Search Central documentation:
Note: Structured data and search results
Even if your structured data is accurate, the way it appears in search results — including whether rich results are shown — is determined by the search engine.
Depending on the search engine's decision, the results may not appear as expected.
For details, see Structured data guidelines for Google Search | Google Search Central.
If you have questions about search results, see I published my site, but it doesn't appear or rank high in Google search results.
How to set up structured data
Note:
These steps include third-party services. Our chat support may not cover the specifications, behavior, or steps beyond what's described here for those external services.
The external service screens and specifications shown in this article are current as of September 2022. If anything differs, please check the external service for the latest information.
1. Prepare your markup code
Create JSON-LD code that matches the content on your page.
You can reference Google's sample code or use the Structured Data Markup Helper tool for a faster workflow.
Tips: Studio.Design's structured data markup field comes with default JSON-LD code. You can edit this code directly without using an external tool.
Open the Google Search Central Structured Data Markup Helper (external link) and find the content type that best matches your needs (e.g., Article, Product, FAQ, etc.).
Copy the sample code for that type and customize it for your site, or use the Markup Helper to fill in the required fields and auto-generate the code.
2. Test your structured data
Verify that your JSON-LD code is properly formatted using Google's external testing tools.
Go to Google's structured data testing tool or a similar validation tool.
Select the "Test code" mode, paste your JSON-LD code, and run the validation.
If any errors or warnings appear, review the details and fix your code accordingly.
If you encounter parsing errors, see Common structured data errors and how to fix them.
Note: You can test using a live preview URL, but you may see errors like "URL cannot be registered with Google" or "Crawl failed."
This is due to how live previews work — just focus on confirming that the structured data is detected correctly.
3. Paste the generated code into your page settings
Once testing is complete, insert the JSON-LD code through Studio.Design's page settings. Note that structured data cannot be set on modals or dynamic modals.
Open the Design Editor for your project.
In the Pages panel, select and open the target page.
In the right panel, select the [Page] tab. If the panel is closed, open the right panel first.
Scroll to the bottom of the Page settings tab, open the [Structured Data] section, and enable [Structured Data Markup].
Insert your JSON-LD code.
Paste the code you prepared with the helper tool, or edit it directly.
※ Only insert the content between
<script type="application/ld+json">and</script>
4. Insert properties (for dynamic pages)
For dynamic pages that display external content from Studio CMS or the Data Connect API, you need to insert properties for values that change per item — such as article titles and body text.
Example: When using Article-type structured data on a CMS article page, set the following properties:
name: Article titleurl: Article page URLimage: Cover imagearticleBody: Article body text
If you want to include "articleSection" (headings) in your structured data, apply the "Extract headings" filter to the article body property.
In the JSON-LD code, click the input field for the item you want to insert.
From the property list, select the target property (e.g., Title, Body, Cover image, etc.).
To use "articleSection," select the Body (or Contents) property, then choose [Extract headings] from the string filter options.
5. Update your site
If you're editing a live site, update your site to publish the changes.
Tips:
Depending on the search engine's crawl schedule, it may take some time for changes to appear in search results. If needed, you can request a recrawl through Google Search Console.
Edit structured data
Open the Design Editor for your project.
In the Pages panel, select and open the target page.
In the right panel, select the [Page] tab. If the panel is closed, open the right panel first.
Scroll to the bottom of the Page settings tab, open the [Structured Data] section, and edit the code.
If you're editing a live site, update your site to publish the changes.
Delete structured data
Deleting structured data removes the JSON-LD output from the page's HTML.
Open the Design Editor for your project.
In the Pages panel, select and open the target page.
In the right panel, select the [Page] tab. If the panel is closed, open the right panel first.
Scroll to the bottom of the Page settings tab, open the [Structured Data] section, and delete the code.
If you're editing a live site, update your site to publish the changes.
FAQ
Q. I can't find the structured data input field.
Q. I can't find the structured data input field.
A. The structured data input is located at the bottom of each page's Page settings tab.
In the Pages panel, select and open the target page.
In the right panel, select the [Page] tab. If the panel is closed, open the right panel first.
Scroll to the bottom of the Page settings tab and open the [Structured Data] section.
Check that the [Structured Data Markup] toggle and input field are displayed.
If you still can't find it, check the following:
Make sure you're not trying to set structured data on a modal or dynamic modal page.
Make sure you have the Page settings tab open, not the Site settings tab.