The Ultimate MerchantReturnPolicy
Schema Generator
A MerchantReturnPolicy provides information about product return policies associated with an Organization, Product, or Offer.
Magic Build
Paste your URL below and our AI will automatically fill the MerchantReturnPolicy fields for you.
Configuration
Live GeneratorWhy use MerchantReturnPolicy?
Output Panel
Want to automate this?
Connect your site to SchemaGen and our AI will automatically extract and deploy schemas for you. No manual coding required.
Launch AI GeneratorWhat is MerchantReturnPolicy Schema?
A MerchantReturnPolicy provides information about product return policies associated with an Organization, Product, or Offer.
Google uses MerchantReturnPolicy structured data to understand the content and context of your pages. When correctly implemented, this schema can unlock rich results in Google Search — enhancing your listing with additional information that dramatically improves visibility and click-through rates.
Why Add MerchantReturnPolicy Structured Data?
Appear in Rich Results
Structured data helps Google show enhanced results for your pages in search — including stars, prices, FAQs, and more.
Boost Click-Through Rate
Rich snippets can increase CTR by up to 30% compared to plain search results — more clicks with the same ranking.
Feed AI Search Engines
AI answer engines like Perplexity and Google SGE use structured data to verify and cite facts from your content.
How to Implement MerchantReturnPolicy JSON-LD
Generate
Use the form above to fill in your details and generate valid MerchantReturnPolicy JSON-LD markup in seconds.
Copy
Copy the generated JSON-LD output code with one click — it's already formatted and ready to deploy.
Deploy
Paste the code into your <head> tag, or use SchemaGen's SDK to deploy without touching code.
Want to skip steps 2 & 3? Connect SchemaGen's SDK to deploy directly from the dashboard.
Properties You Can Include
MerchantReturnPolicy schema supports the following schema.org properties. Required fields are the minimum Google needs to consider your markup valid; recommended fields unlock richer search result appearances.
| Property | Description | Expected Type | Status |
|---|---|---|---|
| additionalProperty | A property-value pair representing an additional characteristic of the entity, e.g. a product feature or another characteristic for which there is no matching property in schema.org.\n\nNote: Publishers should be aware that applications designed to use specific schema.org properties (e.g. https://schema.org/width, https://schema.org/color, https://schema.org/gtin13, ...) will typically expect such data to be provided using those properties, rather than using the generic property/value mechanism. | PropertyValue | Optional |
| additionalType | An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. Typically the value is a URI-identified RDF class, and in this case corresponds to the use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org style guide. | Text, URL | Optional |
| alternateName | An alias for the item. | Text | Optional |
| applicableCountry | A country where a particular merchant return policy applies to, for example the two-letter ISO 3166-1 alpha-2 country code. | Country, Text | Optional |
| customerRemorseReturnFees | The type of return fees if the product is returned due to customer remorse. | ReturnFeesEnumeration | Optional |
| customerRemorseReturnLabelSource | The method (from an enumeration) by which the customer obtains a return shipping label for a product returned due to customer remorse. | ReturnLabelSourceEnumeration | Optional |
| customerRemorseReturnShippingFeesAmount | The amount of shipping costs if a product is returned due to customer remorse. Applicable when property customerRemorseReturnFees equals ReturnShippingFees. | MonetaryAmount | Optional |
| description | A description of the item. | Text, TextObject | Optional |
| disambiguatingDescription | A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation. | Text | Optional |
| identifier | The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See [background notes](/docs/datamodel.html#identifierBg) for more details. | PropertyValue, Text, URL | Optional |
| image | An image of the item. This can be a URL or a fully described ImageObject. | ImageObject, URL | Recommended |
| inStoreReturnsOffered | Are in-store returns offered? (For more advanced return methods use the returnMethod property.) | Boolean | Optional |
| itemCondition | A predefined value from OfferItemCondition specifying the condition of the product or service, or the products or services included in the offer. Also used for product return policies to specify the condition of products accepted for returns. | OfferItemCondition | Optional |
| itemDefectReturnFees | The type of return fees for returns of defect products. | ReturnFeesEnumeration | Optional |
| itemDefectReturnLabelSource | The method (from an enumeration) by which the customer obtains a return shipping label for a defect product. | ReturnLabelSourceEnumeration | Optional |
| itemDefectReturnShippingFeesAmount | Amount of shipping costs for defect product returns. Applicable when property itemDefectReturnFees equals ReturnShippingFees. | MonetaryAmount | Optional |
| mainEntityOfPage | Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See [background notes](/docs/datamodel.html#mainEntityBackground) for details. | CreativeWork, URL | Optional |
| merchantReturnDays | Specifies either a fixed return date or the number of days (from the delivery date) that a product can be returned. Used when the returnPolicyCategory property is specified as MerchantReturnFiniteReturnWindow. | Date, DateTime, Integer | Optional |
| merchantReturnLink | Specifies a Web page or service by URL, for product returns. | URL | Optional |
| name | The name of the item. | Text | Required |
Example MerchantReturnPolicy JSON-LD
Here's what valid MerchantReturnPolicy structured data looks like with sample values filled in. Use the generator above to replace these with your own data.
{
"@context": "https://schema.org",
"@type": "MerchantReturnPolicy",
"name": "Example MerchantReturnPolicy",
"image": "https://example.com/images/example.jpg",
"url": "https://example.com/page",
"additionalProperty": {
"@type": "PropertyValue",
"name": "Example PropertyValue",
"image": "https://example.com/images/example.jpg",
"url": "https://example.com/page"
},
"additionalType": "Example additionalType",
"alternateName": "Example alternateName",
"applicableCountry": {
"@type": "Country",
"name": "Example Country",
"image": "https://example.com/images/example.jpg",
"url": "https://example.com/page"
},
"customerRemorseReturnFees": {
"@type": "ReturnFeesEnumeration",
"name": "Example ReturnFeesEnumeration",
"image": "https://example.com/images/example.jpg",
"url": "https://example.com/page"
}
}Validate Your MerchantReturnPolicy Schema
Once deployed, validate your schema is working correctly with our free audit tool. Paste your URL and we'll check for errors, missing properties, and Google Rich Result eligibility.
Check your MerchantReturnPolicy schema for errors and Rich Result eligibility