Required for Shopping ads and free listings in many countries (Google & ChatGPT)
The shipping attribute lets you set product-level shipping speed and cost. Use it if shipping settings are not configured in Merchant Center or if you need to override them for specific products (e.g., bulky or fragile items).
When to use
- Required for Shopping ads and free listings in the following countries:
Australia, Austria, Belgium, Brazil, Canada, Czechia, Denmark, Finland, France, Germany, Greece, Hungary, India, Ireland, Israel, Italy, Japan, New Zealand, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, South Korea, Spain, Sweden, Switzerland, United Kingdom, United States. - Optional in other countries or when shipping settings are fully managed in Merchant Center.
Format
- Type: Unicode (ASCII recommended)
- Repeated field: Up to 100 times per product
- Schema.org property:
Offer.shippingDetails
The shipping attribute supports sub-attributes:
| Sub-attribute | Required | Description |
|---|---|---|
country | Yes | ISO 3166-1 country code |
region | No | Subdivision code (ISO 3166-2) |
postal_code | No | Postal code or range |
location_id | No | Google Ads API location ID |
location_group_name | No | Predefined location group in Merchant Center |
service | Conditionally | Required if multiple shipping options exist |
price | Required for speed overrides | Shipping cost in target currency |
min_handling_time | No | Minimum handling time in business days |
max_handling_time | No | Maximum handling time in business days |
min_transit_time | No | Minimum transit time in business days |
max_transit_time | No | Maximum transit time in business days |
Supported price ranges by currency:
- AUD, CAD, CHF, EUR, GBP, NZD, SGD, USD: 0–1000
- RO: 0–3000
- AED, BRL, CNY, DKK, HKD, ILS, MYR, NOK, PLN, SAR, SEK, TRY: 0–5000
- ARS, CZK, MXN, THB, TWD, UAH, ZAR: 0–20000
- INR, JPY, PHP, RUB: 0–100000
- KRW: 0–1000000
- HUF: 0–300000
- CLP: 0–500000
- COP: 0–2000000
- IDR: 0–10000000
- VND: 0–20000000
File format examples:
| File format | Example entry |
|---|---|
| Text feed | US:80302:6.49 USD:1:3:2:5 |
| XML feed | See Google Merchant Center docs for full tag structure |
Minimum requirements
- Submit accurate and complete shipping cost and speed data.
- Always provide
country. - Include all relevant costs (shipping, handling, delivery, logistics, insurance).
- Overestimate slightly if exact cost is unknown.
- Match landing page shipping details exactly.
- Comply with local laws.
- Do not include government-imposed fees.
Best practices
- Use Merchant Center account-level settings for most cases.
- Provide multiple shipping options when available.
- Submit prices in correct currency and format.
- Provide handling and transit times to improve delivery estimates.
- Include all regions you ship to.
- For free shipping promotions, use the Merchant Promotions feed.
- Avoid conflicting shipping data for the same region/service.
SEO Tip
Accurate shipping cost and delivery time data increases trust, improves click-through rates, and reduces cart abandonment. High or unclear shipping costs are a major reason for lost conversions.
Official Source : https://support.google.com/merchants/answer/6324484
Need more help?
Our team is here to assist. Reach out and we’ll get back to you fast.
Contact Support