New integrations

As of May 2021, all new integrations are required to use [API based catalog feed management](🔗) to send data and perform index updates.

Images in your product feed are defined with these fields:

  • thumb_image

  • large_image

All products and SKUs must have a **thumb_image** field, which is the URL for thumbnail image of a product or SKU.

To show additional images of a product or SKU, use the **large_image** field. You can have multiple values for an individual product or SKU large_image field. Separate each value with an ASCII character. A pipe ( | ) is a common separator.

## Scenario

Lydia is adding a new product to her product feed. The product is a blouse, and she has multiple images. Two of the images are nearly the same, differing only in size.

File nameImage description
http://www.images.example.com/ruffle-front-v-neck-84324-thumbnail.jpgThumbnail image of the product
http://www.images.example.com/ruffle-front-v-neck-84324.jpgFull-size image of the product
http://www.images.example.com/84324/843-11-rt-999.jpgFull-size image of one of the product's SKUs

She must include a thumbnail image (_thumb_image_) for each product.

In addition to thumbnails, Lydia also wants to include other images of each product or SKU (_large_image_).

## Define the thumb_image field

Lydia starts by defining the product's thumb_image field. She has two images that are the same except for their size. As a best practice, she chooses the smaller image to map to the thumb_image field.

She enters the URL of the thumbnail image:

<thumb_image>http://www.images.example.com/ruffle-front-v-neck-84324-thumbnail.jpg</thumb_image>

The thumb_image field accepts only one value. Each product or SKU can have only one thumb_image field.

## Define the large_image field

Lydia defines the product's large_image field. She enters the URLs for each image, separating each URL with a | character.

<large_image>http://www.images.example.com/84324/843-11-rt-999.jpg|http://www.images.example.com/ruffle-front-v-neck-84324.jpg</large_image>

The large_image field accepts one or more values. For multi-value large_image fields, separate each value with an ASCII character. A | character is a common separator.

## I have two sizes of an image

If you have two images of different sizes, then we recommend that you map the smaller image to thumb_image and the larger image to large_image.