Uploading Swatch Images
The swatches folder in Media Storage is the most common place where uploaded swatch images
are stored. Swatch images that are uploaded to Media Storage are globally available and can be
used by any product. The name of each uploaded image file must exactly match the attribute
value that it represents. In this example, each file name is a color.
Swatches can also be associated with a specific product, and uploaded directly to the product’s
thumbnail gallery. Swatches that are uploaded directly to a product do not appear in the
gallery or in layered navigation. However, in some cases, there are advantages to using this
method. It is also the recommended method for languages with a non-Latin character set, such
as Arabic, Chinese, Cyrillic, or Japanese.
The system uses a “fall back” method to locate swatches. It looks first to see if there are any
swatches associated with the product image. If it doesn’t find a swatch, it then looks in Media
If you use a language other than English for attribute values, it is recommended that you
upload swatch images to each configurable product, rather than to Media Storage. Files
uploaded to Media Storage can only include the characters a-z and 0-9. Characters from nonLatin
alphabets, such as Arabic, Chinese, Cyrillic, and Japanese are not recognized by the
system. To learn more, see the developer documentation.