> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://rubik-combined-listings.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Custom Image Upload

You can assign a dedicated custom image to each swatch. This image does not need to exist in the product media gallery and does not have to be the main product image. It can be any visual you want to use specifically for the swatch.

Custom images are managed through Shopify’s native metaobject editor under the `rubik_swatch` type, which stores the swatch image, category, and color data.

The custom image option becomes available after the product group is saved. In create mode, the button is disabled and shows a tooltip explaining that you can set a custom image after saving the group.

Inside the group table, the swatch thumbnail reflects priority in this order: custom image, color preview, then a plus icon if nothing is set.

For a step by step walkthrough, you can watch the video tutorial here:

[https://www.loom.com/share/4685a3c37fd24d798bbb6fee6200f7e4](https://www.loom.com/share/4685a3c37fd24d798bbb6fee6200f7e4)