> ## Documentation Index
> Fetch the complete documentation index at: https://help.eaglecart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Variant Images, Color Swatches and Storefront Display in Eaglecart

> Add an image or color swatch to each variant in Eaglecart, and learn how variants appear on your store as image tiles, color swatches or text buttons.

[Help Center](https://help.eaglecart.com/introduction.md)

[Products](https://help.eaglecart.com/products.md)

Variant images, color swatches and display

# Variant images, color swatches and display

How a variant looks on your store depends on whether it has an image or a color. Setting these well helps customers see exactly what they're choosing.

## Add a variant image

Each variant can have one image.

1. Open the variant page.
2. In the **Image** card, click **Edit**.
3. Choose an image from Media Manager, or upload a new one. See [Media Manager](https://help.eaglecart.com/settings/media-manager.md).
4. Click **Save**.

The variant's image is separate from the product's **Media** gallery, which is shared by all variants.

## Set a color swatch

For color values, the variant page shows a color picker next to the value in **Variant options**.

1. Open the variant page.
2. Click the color square next to the color value, for example Black.
3. Pick the color.
4. Click **Save**.

## How variants appear on your store

Each variant appears as a choice under its level, for example **Color: Black**:

| Variant has | Shown as | What happens when chosen |
| - | - | - |
| An image | A small image tile | The main product image changes to the variant's image. |
| No image, but a color | A color swatch | The variant is selected. |
| No image and no color | A text button, for example "XL" | The variant is selected. |

Selecting a variant updates the price, stock and **Add to cart** button to match it.

## Practical example

A car in Black, White and Silver:

* Give each variant a photo of the car in that color. Customers see three image tiles, and the main photo changes when they pick one.

A T-shirt with Color and Size:

* Set a swatch color for each color value. Customers see color swatches.
* Leave sizes without images or colors. Customers see text buttons such as S, M and L.

## Theme settings for swatches

The size and shape of swatches, and how product pages show variants, are part of your theme. See [Customize product and collection pages](https://help.eaglecart.com/online-store/product-and-collection-pages.md) and [Colors, fonts and theme settings](https://help.eaglecart.com/online-store/colors-fonts-and-theme-settings.md).

## Troubleshooting

**Why isn't a variant's image changing on the storefront?** Check that the variant has its own image in its **Image** card. A variant without an image shows as a swatch or text button and doesn't change the main photo.

* **A color shows as a text button:** add a color in the color picker next to the value, or add a variant image.
* **The wrong photo shows for a variant:** open the variant and change its image with **Edit**.

## Keep reading

* **Next:** [Edit, add and remove variants](https://help.eaglecart.com/products/edit-add-and-remove-variants.md): change variants after saving.
* [Manage variant pricing, SKUs and stock](https://help.eaglecart.com/products/variant-pricing-skus-and-stock.md): the variant page.
* [Product details, descriptions and media](https://help.eaglecart.com/products/details-descriptions-and-media.md): the product's media gallery.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.