# Media data mapping for Google

Understand how product media maps to Google Merchant Center fields.

Media mapping uses fields within the [ProductVariant](/urn?urn=ctp%3Aapi%3Atype%3AProductVariant) 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](/urn?urn=ctp%3Aapi%3Atype%3AProductVariant). 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](/urn?urn=ctp%3Aapi%3Atype%3AAttributeTextType).

| 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. |

## Related pages

- [Area overview page with navigation](/agentic-commerce.md)