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

# Match images to Shopify products

> Match images automatically or manually, choose products and variants, set a featured image, and review assignments.

Product assignments tell Cloaq.ai which Shopify products should receive your exported images. You can use automatic matching, assign a collection in the bulk window, or manage one image at a time.

Before you start, [connect your Shopify store](https://support.cloaq.ai/shopify/connect-your-store.md) and [import your photos](https://support.cloaq.ai/getting-started/upload-photos-and-folders.md).

## Match automatically

1. Click **Export** in the left navigation.
2. Under **Send to**, choose **Shopify**.
3. Under **Shopify products**, select **Match automatically**.
4. Check the matched-image count beneath **Match products**.
5. Click **Match products** to inspect the assignments and handle images that still need a product.

Automatic matching uses image filenames and imported folder names to match against product titles or SKUs. If you organize photos in folders named for a product or SKU, the folder name can be used to match its images to that product.

Use meaningful filenames or product/SKU folder names before import, then review the results. You can make manual assignments for photos whose names do not identify their products.

## Open the bulk assignment window

Use either entry point:

* In **Export**, choose **Shopify** under **Send to**, then click **Match products**.
* Open the separate three-dot button beside the filmstrip and choose **Assign to Shopify**.

The **Assign images to Shopify products** window shows the product list on the right and image assignments on the left.

![Bulk image assignment window with the product list, photo thumbnails, All and Unassigned filters, and matching status](https://mintcdn.com/cloaq/hk9mSoaUE4pXrLho/images/shopify/shopify-bulk-match-products.png?fit=max\&auto=format\&n=hk9mSoaUE4pXrLho\&q=85\&s=c21fac580cb67a68aae55639a2655b3f)

## Assign photos to a product

1. Select a product from the list on the right.
2. In the lower image area, click a photo to add it to that product.
3. Check the upper area for the product's assigned photos.
4. Repeat for any other photos that belong to the selected product.
5. Select the next product and repeat as needed.

Assignments are saved as you make them. When you have finished, close the window with **×**.

To remove an assigned photo from the selected product, click that photo in the upper assigned-image area.

### Search the product list

Use **Search products by title or SKU** to find a product. Enter its title or SKU, then select the relevant result.

![Shopify product search with matching products and variant choices](https://mintcdn.com/cloaq/hk9mSoaUE4pXrLho/images/shopify/shopify-search-products.png?fit=max\&auto=format\&n=hk9mSoaUE4pXrLho\&q=85\&s=4aeb4f4bcc8491bb605037e3d08d4818)

Clear the search with **×** in the search field to browse the list again.

### Choose a product variant

For products with variants, select **Whole product** or the specific variant before assigning images. The variant choices show details such as size and SKU so you can choose the intended destination.

![Whole product and size/SKU variant choices for a Shopify product](https://mintcdn.com/cloaq/hk9mSoaUE4pXrLho/images/shopify/shopify-product-variants.png?fit=max\&auto=format\&n=hk9mSoaUE4pXrLho\&q=85\&s=4f348a9a0bd7694389a6c291918bd0cc)

### Choose the featured image

In the assigned-image area, select **Featured** on the photo you want to use as the product's featured image.

![Featured checkbox selected on an assigned product image](https://mintcdn.com/cloaq/hk9mSoaUE4pXrLho/images/shopify/shopify-featured-image.png?fit=max\&auto=format\&n=hk9mSoaUE4pXrLho\&q=85\&s=5367249e7cf98d176512a43c65dee9d6)

### Find images that still need assignments

Use **All** to browse the image collection or **Unassigned** to focus on images without product assignments. Green checks and labels such as **In 1 other product** help identify images that already have assignments.

An image can belong to more than one product. Review these indicators before adding or removing a match.

## Manage one image's assignments

1. Close the bulk window if it is open.
2. Click the image's thumbnail in the filmstrip.
3. Find **Shopify products** on the right.
4. Click **+** to open **Add or remove Shopify product**.

You can also open the image's thumbnail three-dot menu and choose **Assign to Shopify**.

![Add or remove Shopify product dialog for one image, with a product search and selectable products](https://mintcdn.com/cloaq/hk9mSoaUE4pXrLho/images/shopify/shopify-image-assignment-dialog.png?fit=max\&auto=format\&n=hk9mSoaUE4pXrLho\&q=85\&s=005396a7345aa877c81d2532e4578fe0)

5. Search by title or SKU, or browse the products.
6. Select the product you want to add.
7. Use **Featured** if this photo should be the product's featured image.
8. Click **Close** when you have finished.

To assign the same image to another product, use **+** again and select the additional product.

To remove an existing assignment from the workspace, hover over its entry in **Shopify products** and click **×**.

![Shopify products panel with an existing assignment, its removal control, and the + button](https://mintcdn.com/cloaq/hk9mSoaUE4pXrLho/images/shopify/shopify-assigned-products.png?fit=max\&auto=format\&n=hk9mSoaUE4pXrLho\&q=85\&s=a66664915dcf49abfeb57c6f93379ad2)

## Review assignments before export

Assigned photos have a Shopify badge on their filmstrip thumbnails.

![Shopify badges on assigned photo thumbnails in the filmstrip](https://mintcdn.com/cloaq/hk9mSoaUE4pXrLho/images/shopify/shopify-filmstrip-badges.png?fit=max\&auto=format\&n=hk9mSoaUE4pXrLho\&q=85\&s=f36185d7053031688e5fa2763fc87eb5)

Select a photo to check its **Shopify products** list and the Shopify details in **Processing → Summary**. Then choose whether exports should **Add** or **Replace** product images.

See [Export images to Shopify](https://support.cloaq.ai/shopify/export-images-to-shopify.md) before starting a run, especially if you are replacing existing product images.

## Troubleshooting

### An image did not match automatically

Check whether its filename or imported folder name identifies the product title or SKU. Use **Match products** or the individual image's **Shopify products** panel to make the assignment manually.

### The photo is assigned to the wrong product

Select the photo, remove the unwanted assignment with **×** in **Shopify products**, then use **+** to select the intended product. Review the product and variant before exporting.

### An image has no product assignment

An unmatched export goes to **Shopify Files only**. Assign the image to a product before processing if you want it to appear among that product's images.

## Related articles

* [Connect and disconnect your Shopify store](https://support.cloaq.ai/shopify/connect-your-store.md)
* [Export images to Shopify](https://support.cloaq.ai/shopify/export-images-to-shopify.md)
* [Manage imported images in the filmstrip](https://support.cloaq.ai/getting-started/manage-imported-images.md)


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