Working with images and image upload

Key features

• The CMS automatically scales and compresses uploaded images
• Upload images at least twice the width of your widest content block
• Prefer .jpg over .png unless transparency is needed

Primary guidelines

• The image width should be at least twice your widest content block (your widest is the 1 column block). The height is fully dynamic.
• Always upload .jpg files instead of .png, unless transparency is needed, which is very rare.
• Do not compress the image with external services before uploading. The system handles compression during upload.

Automatic compression and image scaling

When an image is uploaded, the CMS image service compresses it and serves the dimensions needed for various content areas on the storefront. The browser then determines which dimension to display based on screen size (responsiveness), for example 2560px, 900px, or 425px wide.

This all happens automatically, so the uploaded image only needs to be at least twice the width of the largest area (for example, 1360px x 2 = 2720px). If you're unsure of the width you need, about 2800px wide is usually sufficient.

You therefore don't need to worry about anything other than ensuring the image is wide enough during upload, whether it's for a quarter-column or a full-width hero banner. This keeps images large enough to maintain good quality, regardless of the column width they're placed in.