Best practices for uploading images

Throughout the app, you can upload any size image you want, and it will automatically be resized to the appropriate resolution. For example, a 4000 x 8000 product image will be displayed at 1000 x 2000 or 300 x 600 depending on the size of the container presenting it. You don't have to worry about image compression or fiddling with exact dimensions, just make sure it looks crisp on your computer and is the correct aspect ratio. Below are some suggestions depending on what part of the app you are in.

Catalog Products

These can be any size and shape you want, just note that they live on a responsive grid, so it's a good idea to have them all roughly the same aspect ratio so nothing's too tall or short.

Catalog Header

The catalog header resizes and crops automatically to best fit the screen. For best results, upload an image at least 500 x 1500 and make sure important elements (like text) are toward the middle so they don't get dynamically cropped.

We recommend going full-bleed on this and not putting crucial information around the edges, since it gets reformatted responsively and can have slightly different dimensions on mobile vs. widescreen. You can preview it in real-time as you work on it, and what you see is what you get.

Examples of the same header at different screen sizes:

Brand Card

The brand card itself is 320 x 320, so any square image will do:

The adjacent boxes are optional, in case you want to turn your brand card into a slider (we support up to three brand card images that can be manually scrolled between on the Discover page). You can drag and drop them in the editor to reorder or delete them.

Storefront: Header

There are three different layout options for your Storefront header, which we're going to call XL, LSS, and MMM:

Here are examples of what each one looks like in situ:

You can shuffle the same images around into any configuration you want, but here are the rendered image sizes for each layout:

• XL = 1400 x 480
• LSS = 933 x 480, 507 x 240, 507 x 240
• MMM = 480 x 480, times 3

Each one crops differently, so you can experiment with the WYSIWYG editor and see what you like. Generally speaking, people with existing wide-format banners usually go with full width – the other options are generally for people who don't want to mess around in Photoshop and just make something nice with their existing product / editorial photography.

Storefront: Product Images

Finally, the optional Product Images on your storefront have very specific layout guidelines. The grid itself adapts to however many you upload, but the overall dimensions are:

• S = 444 x 341
• L = 582 x 341

Troubleshooting missing catalog images

If your noticing images are missing in either your product list, catalog, or both, the most likely culprit is the image name itself. Two of the main causes are outlined below.

1. Repeated image names or images that share the same naming system even though they are different products can sometimes not load in Candid. When our system sees images with the same name it can read that as meaning "all these pictures are the same picture" and it will pick one picture and repeat it for every product.
2. Using special characters in image names can also cause some images not to load in Candid. Using only accepted characters in image names will help you maximize compliance with DNS, web-safe characters, XML parsers, and other APIs. These are the current accepted characters:
   • Alphanumeric characters: 0-9 , a-z , A-Z
   • Special characters: ! , - , _ , . , * , ' , ( , )