> ## 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.

# Troubleshoot processing and downloads

> Check the queue, partial downloads, output formats, target sizes, folders, and swatch files.

Use these checks when the processing queue or downloaded output differs from what you expected.

## The queue contains more photos than I intended

**Process all** adds the entire collection each time it is clicked. If you intended to process a selection or continue a remaining queue, it can add extra photos.

1. **Pause** the run if it is active.
2. Open **Queue**.
3. Review the pending photos.
4. Hover over an unwanted pending photo and click × to remove it.
5. **Resume** when the queue contains the photos you intend to process.

To empty the queue and rebuild it, cancel the run, keep the ZIP of completed images, then use **Clear**. To build a selection, use **Add to queue** from each photo thumbnail's menu, then click **Process**.

[Pause, resume, cancel, or clear processing](https://support.cloaq.ai/image-export/manage-processing-queue.md)

## I canceled processing and only some images are in the ZIP

**Cancel** produces a ZIP containing the images completed before the run stopped. Remaining unprocessed photos stay in **Queue**.

Open **Queue** and click **Process** to continue those photos. Use **Resume** instead if the run is paused. Avoid clicking **Process all** to continue the queue, because it adds the full collection again.

## Why did completed images count toward the export allowance?

Images already processed count toward the allowance even when the run is later canceled. Keep the partial ZIP to retain that completed output.

## I cannot find the downloaded ZIP

First check **Export → Send to**. Use **Download** when you need a ZIP on your computer. If **Shopify** is selected, review the [Shopify export workflow](https://support.cloaq.ai/shopify/export-images-to-shopify.md) instead.

Check your browser's downloads list and the location you selected in its save dialog. If you chose Downloads, look there for the ZIP from the run.

Do not start another full run solely to locate a file that may already have downloaded.

## The output is PNG even though I selected JPEG

Check the background preset in **Cutout and shadows**. A transparent background automatically uses PNG regardless of the format in **Export** settings.

[Replace a background or create a transparent cutout](https://support.cloaq.ai/cutouts-and-shadows/replace-or-remove-background.md)

## The JPEG is not exactly the requested file size

**Aim for file size** is a target. Cloaq.ai tries to reach it and uses the closest possible value if the exact size is not achievable.

Review the requested value and unit in **Export** settings.

[Configure export size, format, and quality](https://support.cloaq.ai/image-export/export-settings.md)

## The folder organization differs from the original collection

Uploading individual files places processed images together in the ZIP. Uploading a folder preserves the nested folder structure in the ZIP.

Choose folder upload when preserving that structure is part of your workflow.

[Upload photos and folders](https://support.cloaq.ai/getting-started/upload-photos-and-folders.md)

## There are extra numbered files beside my exported photos

These can be the colour and fabric swatches associated with the photos. Swatch files use the photo's base name with an added number.

Review **Colour and fabric swatches** before processing, and remove unwanted swatches with the × that appears on hover.

[Add and remove colour and fabric swatches](https://support.cloaq.ai/getting-started/colour-and-fabric-swatches.md)

## Need more help?

For images that went to Shopify Files without appearing on a product, check [Shopify product assignments](https://support.cloaq.ai/shopify/match-images-to-products.md) and the [Shopify export troubleshooting steps](https://support.cloaq.ai/shopify/export-images-to-shopify.md#troubleshooting).

[Contact Cloaq.ai support](https://support.cloaq.ai/getting-help/contact-support.md).


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