| 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.
A photoshoot took place and now there are more specific pictures available for each sku. The following file assigns them to each variants.
After this file is processed, the previously imported 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.
