How to use the JSON-LD generator
- Choose a schema type. A short description explains when to use it.
- Fill in the form. Required properties are marked (required), and the ones that improve eligibility are marked (recommended).
- For dates, choose the UTC offset of the time zone where the event or publication happens.
- Read the checks, fix anything marked Fix, and consider the Check suggestions.
- Copy the script tag into the page’s
<head>or<body>. - Test it with Google’s Rich Results Test and the Schema.org validator before publishing.
Each type keeps its own values, so you can switch types without losing your work. Sample restores the example and Clear empties the form.
How it works
The form values are turned into a schema.org object with @context and @type, nested where the vocabulary expects it: an Offer inside a Product, a PostalAddress inside a LocalBusiness, a Person as an article’s author. Empty fields are left out instead of written as empty strings. Some conversions are automatic:
- date-times get seconds and your chosen offset, for example
2026-11-20T10:00:00+01:00; - recipe times in minutes become ISO 8601 durations (
PT15M), with a total time added; - availability and attendance become full schema.org URLs;
- FAQ and breadcrumb lists are written one per line as
left | rightand become arrays.
In the output, < is escaped as <, so a value containing </script> can never close the tag early.
Worked examples
Example 1: an article
The Article sample has a headline, image, author with profile URL, publisher and both dates with a −05:00 offset. All checks pass. Search engines use this to show the right date and author with the article.
Example 2: a local business
Switch to Local business, choose Store as the type and fill in the address, phone and opening hours such as Mo-Fr 07:00-18:00. The required street address and city are checked. Make sure the details match your Google Business Profile.
Example 3: breadcrumbs
Enter Home | https://www.example.com/, then one line per level down to the current page. Positions are numbered automatically. The last item may leave out the URL, because it’s the current page.
Choosing the right type
Use the most specific type that matches what the page is mainly about: a product page gets Product (not Organization), a recipe blog post gets Recipe (not just Article). Add Organization and WebSite markup once, on the home page.
Common mistakes
- Marking up content that isn’t on the page, such as reviews users can’t see.
- Prices or ratings that differ from the visible page.
- Relative image URLs. Use absolute
https://URLs. - Dates without time zones, which can shift events by hours.
- Copying one page’s markup to every page, which creates duplicate, inaccurate data.