# Product schema generator (JSON-LD)

Product schema is a JSON-LD block that tells Google a page's product name, price, availability, returns and shipping in a machine-readable form. Fill in the fields below to get a validated script tag you can paste into your product page.

Free, runs in the browser: https://listvane.com/tools/product-schema-generator

Runs in your browser. Nothing you paste or open here is uploaded; it stays on your device.

## How to use it

1. Fill in the product name, page URL, image URLs, brand and GTIN or MPN exactly as they appear on the product page.
2. Enter the price as a plain number, the three letter currency code, and the availability that matches the page today.
3. Turn on the return policy and shipping sections and enter the same terms your site publishes.
4. Fix anything marked Fix in the results, then copy the script tag.
5. Paste it into the product page template, inside the head or at the end of the body, and test the live URL in Google's Rich Results Test.

## What each part of the markup does

| Property | Used for |
| --- | --- |
| `name`, `image`, `description` | Identifies the product in search results and image panels |
| `gtin`, `mpn`, `brand` | Matches the product to the same item in Merchant Center |
| `offers.price`, `priceCurrency` | The price Google can show beside the listing |
| `offers.availability` | In stock, out of stock or pre-order label |
| `hasMerchantReturnPolicy` | Return window, method and fees |
| `shippingDetails` | Shipping cost and delivery time estimate |

If the page and the markup disagree, Merchant Center reports it. See [mismatched product price](/issues/mismatched-product-price), [missing or incorrect GTIN](/issues/missing-or-incorrect-gtin), [missing brand](/issues/missing-brand) and [missing return and refund policy](/issues/missing-return-and-refund-policy).

## Questions

**Where do I paste the JSON-LD?**

Put the script tag in the HTML of the product page, in the head or the body. Most store platforms have a theme template for product pages where it goes. Generate one block per product page, filled from that product's own data.

**Does schema markup replace my Merchant Center feed?**

No. Markup on the page and the feed are separate data sources, and Google compares them. If the price or availability in your markup differs from the feed or the visible page, Merchant Center can flag a mismatch.

**What does the markup have to match?**

Everything in it must match what a shopper sees on that page: the price, the stock status, the return window and the shipping cost. Markup for things the page does not show can lose you rich results.

**Do I need the return policy and shipping fields?**

They are optional for Product rich results, but Google can show return and shipping information in listings when they are present. They also have to agree with the policy pages on your site.

**Should price include tax?**

Follow the way your store shows prices. In the US the price normally excludes sales tax. In countries where displayed prices include VAT, use the VAT-inclusive price, matching the page.

**Can I add reviews I collected elsewhere?**

Only if the reviews are shown on the product page. Rating markup for reviews shoppers cannot see on the page goes against Google's structured data rules.

## Sources

- [Google Search Central: Product structured data](https://developers.google.com/search/docs/appearance/structured-data/product)
- [Google Search Central: Merchant listing structured data](https://developers.google.com/search/docs/appearance/structured-data/merchant-listing)
- [Google Search Central: Merchant return policy structured data](https://developers.google.com/search/docs/appearance/structured-data/return-policy)
- [Google Search Central: Shipping policy structured data](https://developers.google.com/search/docs/appearance/structured-data/shipping-policy)
- [schema.org: Product](https://schema.org/Product)

---

Markup is one of many things Google compares: Merchant Center checks your markup, your feed and your store pages against each other. Listvane scans the public site for what its reviews flag, such as mismatched prices, missing policies and contact details, and scores it before you appeal. https://listvane.com/issues/merchant-listing-structured-data-invalid?ref=free-tool-lv-schema

Listvane is an independent tool made by Great Work LLC. It isn't affiliated with, endorsed by or sponsored by Google. Google and Google Merchant Center are trademarks of Google LLC.
