Add Shipping and Returns Schema to Magento 2
Looking for Magento 2 Rich Snippets extension? View the full Magento 2 Rich Snippets extension page to explore features, configuration options, and pricing.
Configure OfferShippingDetails and MerchantReturnPolicy schemas with the Rich Snippets Suite extension. These schemas provide shipping costs and return policy information directly in Google Search results.
Why Shipping & Return Schemas Matter
Google can display shipping and return information in product rich results:
- Shipping cost shown before clicking
- Delivery time expectations
- Return policy details
- Free returns indicator
This information helps customers make purchase decisions and can improve click-through rates.
Shipping Details Schema
OfferShippingDetails tells Google about your shipping options per country.
Managing Shipping Details
Location: Marketing → Rich Snippets → Shipping Details
This grid allows you to configure shipping information for different countries.
Adding Shipping Configuration
Click Add New and fill in:
| Field | Description | Required |
|---|---|---|
| Shipping Country | Two-letter country code (NL, DE, US) | Yes |
| Shipping Region | Region/state code (optional) | No |
| Shipping Price | Base shipping cost | Yes |
| Shipping Price Currency | Currency code (EUR, USD, GBP) | Yes |
| Min Handling Time | Minimum days to process order | Yes |
| Max Handling Time | Maximum days to process order | Yes |
| Min Transit Time | Minimum shipping days | Yes |
| Max Transit Time | Maximum shipping days | Yes |
Example Configurations
Netherlands - Standard Shipping:
| Field | Value |
|---|---|
| Country | NL |
| Price | 4.95 |
| Currency | EUR |
| Handling | 1-2 days |
| Transit | 1-2 days |
Germany - Standard Shipping:
| Field | Value |
|---|---|
| Country | DE |
| Price | 6.95 |
| Currency | EUR |
| Handling | 1-2 days |
| Transit | 2-4 days |
Free Shipping:
| Field | Value |
|---|---|
| Country | NL |
| Price | 0 |
| Currency | EUR |
| Handling | 1-2 days |
| Transit | 1-2 days |
Enabling Shipping Details
After adding configurations:
- Go to Magmodules → Rich Snippets Suite → Schema: Shipping Details
- Set Enable to Yes
- Choose Shipping Details: All or Specific entries
- Click Save Config
Return Policy Schema
MerchantReturnPolicy tells Google about your return conditions per country.
Configuring Return Policies
Location: Magmodules → Rich Snippets Suite → Schema: Return Policy
| Setting | Description |
|---|---|
| Enable | Enable return policy schema |
| Returns | Configure per-country return policies |
Return Policy Fields
For each country, configure:
| Field | Description |
|---|---|
| Country | Country code this policy applies to |
| Return Fee | Cost for returns, or https://schema.org/FreeReturn for free returns |
| Return Days | Number of days customers can return |
Free Returns
To indicate free returns, enter the exact URL:
https://schema.org/FreeReturn
Paid Returns
For returns with a fee, enter the amount:
5.95
Example Return Policies
Netherlands - Free Returns:
| Country | Fee | Days |
|---|---|---|
| NL | https://schema.org/FreeReturn | 30 |
Germany - Paid Returns:
| Country | Fee | Days |
|---|---|---|
| DE | 4.95 | 14 |
Schema Output Examples
OfferShippingDetails
{
"@type": "OfferShippingDetails",
"shippingRate": {
"@type": "MonetaryAmount",
"value": "4.95",
"currency": "EUR"
},
"shippingDestination": {
"@type": "DefinedRegion",
"addressCountry": "NL"
},
"deliveryTime": {
"@type": "ShippingDeliveryTime",
"handlingTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 2,
"unitCode": "DAY"
},
"transitTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 2,
"unitCode": "DAY"
}
}
}
MerchantReturnPolicy
{
"@type": "MerchantReturnPolicy",
"applicableCountry": "NL",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 30,
"returnFees": "https://schema.org/FreeReturn"
}
Best Practices
Shipping Details
- Add entries for all countries you ship to
- Use accurate handling and transit times
- Update prices when shipping costs change
- Consider adding free shipping thresholds
Return Policy
- Match your actual return policy terms
- Be accurate about return windows
- Clearly indicate if returns are free or paid
- Keep policies current with legal requirements
Consistency
- Ensure schema matches your website policies
- Same information on product pages
- Consistent with checkout display
- Matches legal terms and conditions
Connecting to Product Schema
Shipping and return information automatically connects to your Product schema's Offer:
{
"@type": "Product",
"offers": {
"@type": "Offer",
"price": "99.99",
"shippingDetails": { ... },
"hasMerchantReturnPolicy": { ... }
}
}
Need More Help?
Documentation:
- All Help Articles - Complete documentation overview
Support:
- Contact Support - Get help from our team
For a complete overview of features and configuration options, see Magento 2 Rich Snippets extension.