Skip to content

Bulk upload swatch images

Attach a folder of swatch images in one go, matched by filename

Use with AI

Use with AI

Ready-made prompts Connect your AI to Pasilobus Install the CLI

This page

View as MarkdownPlain text of this page Open in ClaudeAsk about this page Open in ChatGPTAsk about this page

Ready-made prompts

Fill in the parts in angle brackets, then paste into any assistant.

Step by step on your store

Read https://help.pasilobus.com/combined-listings/bulk-swatch-upload.md. Walk me through bulk upload swatch images in Swatches & Listings for my store, step by step. My theme is <theme name> and I want <what you want to happen>.

Ask your own question

Read https://help.pasilobus.com/combined-listings/bulk-swatch-upload.md. Answer this about Swatches & Listings on my store: <your question>.

Ask Shopify Sidekick

In your Shopify admin, ask Sidekick about Swatches & Listings. It searches these guides.

Connect your AI to Pasilobus Beta

Our MCP server lets Claude, ChatGPT, OpenClaw and other MCP clients use your Pasilobus apps. It is in beta and open to every Pasilobus account: you sign in with it when your assistant asks. Tools that change your store are marked as changes, so your assistant asks you first.

https://cloud.pasilobus.com/mcp

In Claude Code, add it, then run /mcp to sign in:

claude mcp add --transport http pasilobus https://cloud.pasilobus.com/mcp

In Claude on the web or desktop, go to Customize › Connectors › Add custom connector and paste the address. In ChatGPT, OpenClaw or another client, add it as a custom connector (MCP) with the same address.

Install the CLI

npm install -g pasilobus

Run your apps from the terminal or a coding agent. These only read, so they are safe to try:

pasilobus combined-listings summary

Count the store's combined listings, grouped products and swatches

pasilobus apps lists your apps on the store; pasilobus <app> help lists what each app can do. How it works

On this page
  1. How to upload
  2. How filenames are matched
  3. What happens next
  4. Limits

If you already have swatch images in a folder, you do not have to attach them one at a time. Zip the folder, drop it in, and each image is matched to the value its filename names.

How to upload

  1. Open Swatches and choose the option the images belong to
  2. Choose Bulk upload swatch images
  3. Drop the .zip in, and upload

The page shows how many images matched when it finishes, and lists any that matched nothing.

How filenames are matched

Name each file after the value it belongs to. Capitals, spaces, dashes and underscores are ignored, so Sea Foam.jpg, sea-foam.JPG and SEA_FOAM.png all match a value called Sea Foam.

Anything that is not an image is skipped, so a folder with a stray notes file or a .DS_Store is fine. Files that match no value are listed back to you rather than dropped silently — usually a spelling difference between the filename and the value.

What happens next

Matched images are attached to their values and become swatches on your storefront. On a large upload they are sent to Shopify a few at a time rather than all at once, so a folder of five hundred images takes a few minutes to appear everywhere.

Limits

A zip can hold up to 2,000 images, and each image up to 20 MB. Uploading again replaces the images for the values that match; values you did not include are left alone.

Talk to a person.

The people who build our apps answer support themselves. Send us a message or email us, and a person replies, usually within one business day. There's no chat.