Understand how product media maps to Google Merchant Center fields.
Media mapping uses fields within the ProductVariant type. Product images are extracted from the Variant's
images array, while video and 3D model links require dedicated Variant-level Attributes.Image fields
| Google Merchant Center field | Related commercetools field | Required | Mapping logic |
|---|---|---|---|
image_link | variant.images[0].url | Required | Must be a direct HTTPS link to an image file. Supported formats: JPEG, PNG, WebP, GIF, TIFF, BMP. Extract the url from the first entry in the images array of the ProductVariant. No watermarks. |
additional_image_link | variant.images | Optional | Loop through the images array starting from the second entry (index 1) and extract the url of each image to a comma-separated list. Maximum of 10 additional images. Maximum of 2000 characters. Same format as image_link. AI-generated images must contain metadata indicating they were AI-generated. |
Video and 3D model fields
The
video_link and model_3d_link fields require Variant-level Attributes. These Attributes should be of type AttributeTextType.| Google Merchant Center field | Related commercetools field | Required | Mapping logic |
|---|---|---|---|
video_link | variant.attributes.videoLink | Optional | Must be a direct link to a publicly accessible video. For example: a YouTube or CDN link. |
model_3d_link | variant.attributes.model3dLink | Optional | Must be a direct link to a publicly accessible 3D model file. For example: https://example.com/model.glb. Available only in the US. |
Mobile-specific fields
| Google Merchant Center field | Related commercetools field | Required | Mapping logic |
|---|---|---|---|
mobile_link | store.custom.fields.mobileStoreUrl and productData.slug[<locale>] | Optional | Construct the mobile-optimized product URL if it differs from the standard link. Maximum of 2000 characters. |