How to use
- Choose a Structured data type: Article, FAQ page (FAQPage), Product, Local business or Breadcrumb trail (BreadcrumbList), whichever fits the page.
- Fill in the fields. Example values are already there, so just replace them with yours.
- Read the Fix these and Recommended boxes that appear. They flag empty required fields and wrong date, URL or price formats.
- Copy the result into your page’s
<head>or<body>. Pick JSON only to get the JSON body without the<script>tag.
What goes into each type
| Type | Typical values | Close to required |
|---|---|---|
| Article | Headline, image, dates, author, publisher | Headline |
| FAQPage | Several question and answer pairs | At least one pair |
| Product | Name, image, brand, SKU, price and currency, availability, rating and review count | Name, plus a price (with currency) or a rating |
| LocalBusiness | Name, address, phone, opening hours, latitude and longitude, price range | Name, address |
| BreadcrumbList | A list of name and URL pairs | Two or more items |
A few input formats are worth knowing.
- FAQ: write
Q: questionand thenA: answeron the next line. Items are separated by a blank line or the nextQ:, and an answer may span several lines. Without markers, blank-line blocks work too and the first line is read as the question. - Opening hours:
Mo-Fr 09:00-18:00. Several days look likeSa,Su 10:00-16:00. Korean day names such as 월-금 are converted for you. - Breadcrumbs: one
name | URLper line, and the last line (the current page) may leave out the URL. Positions 1, 2, 3 are added in order. - Price:
12,900is cleaned to the number12900. The currency is a 3-letter uppercase code such asUSDorKRW. - Dates:
2026-10-19or2026-10-19T09:00:00+09:00. Dates that do not exist, such as February 30, are errors.
Pasting it safely
In the generated <script type="application/ld+json">, the characters <, > and & are replaced with escapes such as <, so a value containing </script> cannot close the tag early. When read as JSON the original characters come back exactly, so the meaning does not change. If you build code that copies user-submitted text into structured data automatically, apply the same escaping on your server.
Rules for using structured data
- It must match what the page shows. Adding a price, rating or question that is not on the page can violate search engine guidelines and cost you.
- FAQ rich results are limited. Since August 2023 Google shows FAQ rich results mostly for well-known government and health sites. The markup is still valid and can help other search engines and AI tools understand the content.
- Validate it. Run the result through Google’s Rich Results Test or the schema.org validator before publishing. This tool checks formats but cannot guarantee every requirement of a particular search engine.
- For meta tags and share cards use the Meta Tag Generator, and to tidy JSON use the JSON Formatter.
FAQ
Should JSON-LD go in the head or the body?
Either works. It usually goes in <head>, but Google also reads it in <body>. A page can hold several <script type="application/ld+json"> blocks, so you can build an article and a breadcrumb separately and paste both.
Does structured data raise my ranking?
It does not raise rankings directly. It helps stars, prices or breadcrumbs appear in results, which can affect click-through, and it helps engines understand the page precisely.
Will adding FAQ markup expand questions in search results?
For most sites, not since August 2023, because Google limited it to well-known government and health sites. The markup is still valid.
Can I put any number as a product rating?
Use only the average rating and review count that are shown on the page. Rating and review count must be given together, and a rating above 5 on a 5-point scale triggers a warning.
Is my input sent anywhere?
No. Values are processed only in your browser and are never sent to a server.