Understand how shipping and fulfillment information maps to Google Merchant Center fields.
Shipping data in Google Merchant Center defines the delivery options, costs, and handling times for your products. This data is derived from ShippingMethods configured at the Project level in commercetools.
Shipping fields
Shipping configuration in Google Merchant Center can be managed at the account level or overridden per product using product-level attributes. The following fields map product-level shipping information.
| Google Merchant Center field | Related commercetools field | Required | Mapping logic |
|---|---|---|---|
shipping | shippingMethod.zoneRates | Conditionally required | Required for select countries (Australia, Austria, Belgium, Canada, Czechia, France, Germany, India, Ireland, Israel, Italy, New Zealand, Japan, the Netherlands, Poland, Romania, South Korea, Spain, Switzerland, the UK, and the US). Format: country:region:service:price. For example: US:CA:Overnight:16.00 USD:1:1:2:3. |
carrier_shipping | shippingMethod.zoneRates.zone | Optional | Alternative to shipping attribute for carrier-based rates. Up to 10 per Product (combined with shipping max). Format: country:region:postal_code:origin_postal_code:location_id:location_group_name:flat_price/carrier_price:carrier_price_adjustment:min_handling:max_handling:fixed_transit/carrier_transit.For example: US:CA:94043:USPS_MEDIA_MAIL:1:3:USPS_MEDIA_MAIL. |
shipping_label | variant.attributes.shippingLabel or shippingMethod.name | Optional | Maximum of 100 characters. Use a custom Attribute or derive from the Shipping Method name. For example: Sameday. |
shipping_weight | variant.attributes.weight | Conditionally required | Required for accurate shipping calculation. Format: value and unit (lb, oz, g, kg). Range: 0-2000 lbs for imperial, 0-1000 kg for metric. For example: 1.5 kg. |
shipping_length | variant.attributes.length | Optional | Package dimension. Format: value and unit (in, cm). Range: 1-150 for inches, 1-400 for cm. For example: 10 cm. |
shipping_width | variant.attributes.width | Optional | Package dimension. Format: value and unit. For example: 5 cm. |
shipping_height | variant.attributes.height | Optional | Package dimension. Format: value and unit. For example: 3 cm. |
Handling time fields
If using handling time fields, you must create Variant-level Attributes of type AttributeNumberType.
| Google Merchant Center field | Related commercetools field | Required | Mapping logic |
|---|---|---|---|
max_handling_time | variant.attributes.maxHandlingTime | Optional | Maximum processing time in days as an integer. For example: 3. |
min_handling_time | variant.attributes.minHandlingTime | Optional | Minimum processing time in days as an integer. For example: 1. |
Shipping origin
| Google Merchant Center field | Related commercetools field | Required | Mapping logic |
|---|---|---|---|
ships_from_country | variant.attributes.originCountry or derived from inventory supply Channel | Optional | ISO 3166-1 alpha-2 country code (2 characters). Use a custom Attribute or derive from the inventory supply Channel location. |
Free shipping threshold
| Google Merchant Center field | Related commercetools field | Required | Mapping logic |
|---|---|---|---|
free_shipping_threshold | shippingMethod.zoneRates[].shippingRates[].freeAbove | Optional | Convert centAmount to decimal using fractionDigits. For example: 10.00 USD. Uses ISO 4217 currency code. |