| File Prefix | PRODUCT-IMAGES |
| Current Version | V2 |
| Attribute | Format | Length | Required | Description | Example |
| product_ref | Alphanumeric | 1-255 | Yes | Unique product reference descriptor | 103495 |
| skus | Alphanumeric ; separated list | 1-255 | No | SKU(s) of product variant. Leave blank to indicate the image applies to the product | B01N53LF;B02N53LF |
| image_url | URL | 1-65535 | Yes | Image URL. JPG and PNG images are supported | https://bspk.com/xkcd.jpg |
| position | Numeric | | Yes | Order. This position is absolute for the product, meaning a same product_ref should contain only one position in its group of rows | 2 |
The image_url content must be publicly accessible. The image will be downloaded and stored into BSPK CDN.
Processing Images
The list of images for a product in a given file is considered canonical. This means that every time an import file is processed, when the first instance of a given product reference is encountered, all the existing images associated with that product will be removed.
This provides a deterministic way to express what images should be associated with a product and its variants.
Example
A new product is added to the catalog. There is only one image available. The following file assigns it to the product, but no specific variants.
product_ref,skus,image_url,position
300,,https://bspk.com/image1.jpg,1
product_ref,skus,image_url,position
300,,https://bspk.com/image-var1.1.jpg,1
300,VAR1,https://bspk.com/image-var1.2.jpg,2
300,VAR2,https://bspk.com/image-var2.1.jpg,3
300,VAR3;VAR4,https://bspk.com/image-var2.1.jpg,4
image1.jpg is no longer associated with the product.
image_url are cached. If a same url is encountered, the content will not be downloaded again. If you change an image, make sure the file name is different.
