Mapping variation images requires just a few custom column headers and values.

Note: Before beginning this tutorial, we recommend you are familiar with variation CSVs. Also, if you are on mobile, the tables in this article may be easier to view on a desktop.


For quick reference, these are the basic variation image column headers:

VariationImageOption

VariationImageValue1

VariationImage1_1

Getting Started

For this example, we have

  • two item specifics that are variation options (Color and Size)

  • with two variation values for each option (red, blue, and 2, 3)

SKU

Parent SKU

Color

CustomSpecificSize

skuPARENT

sku-red-2

skuPARENT

red

2

sku-red-3

skuPARENT

red

3

sku-blue-2

skuPARENT

blue

2

sku-blue-3

skuPARENT

blue

3


Step 1 - Choose a Variation Option for Images

eBay will only allow variation images for one variation option.

Because of this, we must choose either "Color" or "Size" for the variation images. (even if your item only has one variation option, you must set this)

Let's choose "Color" as the option for our variation images.

  • To do this, use the column header "VariationImageOption" and set the Parent cell to Color.

Color

CustomSpecific Size

VariationImageOption

Color

red

2

red

3

blue

2

blue

3

Important: Only use the Parent row to insert variation image data, do not use variation rows.


Step 2 - Set Images for a Variation Value

Next, let's set variation images for the Color value, "red"

  • Use the column header "VariationImageValue1" and set the Parent cell to red.

Color

VariationImageOption

VariationImageValue1

Color

red

red

red

blue

blue

Note: Each variation image value will progress in this order: VariationImageValue1, VariationImageValue2, VariationImageValue3, VariationImageValue4, etc.

Now, we will set two images for "red"

  • Use column headers VariationImage1_1 and VariationImage1_2

  • and provide the image URLs for red variation images:

Color

VariationImageOption

VariationImageValue1

VariationImage1_1

VariationImage1_2

Color

red

example.com/red.jpg

example.com/rd.jpg

red

red

blue

blue

Note: you can set up to 12 variation images progressively for each variation value (VariationImage1_1, VariationImage1_2, VariationImage1_3, VariationImage1_4, etc)


Step 3 - Set Variation Images for Other Variation Values

To set the images for blue, we will repeat step 2, but change the identifying number in the value/image column headers like so:

  • VariationImageValue2

  • and VariationImage2_x

Color

VariationImageOption

VariationImageValue1

VariationImage1_1

VariationImage1_2

VariationImageValue2

VariationImage2_1

VariationImage2_2

Color

red

example.com/red.jpg

example.com/rd2.jpg

blue

example.com/blue.jpg

example.com/blu.jpg

red

red

blue

blue

Note: You can add more variation values and images by repeating step 2 again and changing the column header's identifying number to +1 of the previous.

(e.g.

  • VariationImageValue3/VariationImage3_x,

  • VariationImageValue4/VariationImage4_x,

  • VariationImageValue5/VariationImage5_x,

etc)


Step 4 - Import and Turn On Variation Photos

After importing your CSV, edit the draft listing with the variation images and enable the variation option you set.

And your photos will be uploaded and ready to publish:

Did this answer your question?