Unless otherwise noted, images must be uploaded in a supported format (SVG, PNG, JPG/JPEG, or GIF) and be no larger than 2 MB.
The following outlines image requirements by feature area, including upload method, recommended dimensions, file size limits, and supported formats.
Customer Portal v2
Banner image
Upload method: Image URL
Preferred aspect ratio: 16:9
Validation: Must be a valid
http://orhttps://URLOptional: Banner image link (click-through URL)

Loyalty logo
Upload method: Image URL
Validation: Valid URL format

Customer Portal CPv3
Login splash image (desktop)
Upload method: Drag-and-drop file upload
Recommended aspect ratio: 3:4 (portrait)
Max file size: 2 MB
.png?sv=2022-11-02&spr=https&st=2026-03-03T23%3A48%3A27Z&se=2026-03-03T23%3A59%3A27Z&sr=c&sp=r&sig=z17DjIdzydsMaizDOGsUrYSzGiZ4b8%2Fh7FXhFhu4og4%3D)
Login splash image (mobile)
Upload method: Drag-and-drop file upload
Recommended aspect ratio: 3:1 (landscape)
Max file size: 2 MB

Subscription custom banner (desktop & mobile)
Upload method: Drag-and-drop file upload (separate images for desktop and mobile)
Recommended aspect ratio: 3:1 (for example, 1200 × 400 px)
Max file size: 2 MB
Optional: Banner link (click-through URL)
.png?sv=2022-11-02&spr=https&st=2026-03-03T23%3A48%3A27Z&se=2026-03-03T23%3A59%3A27Z&sr=c&sp=r&sig=z17DjIdzydsMaizDOGsUrYSzGiZ4b8%2Fh7FXhFhu4og4%3D)
Loyalty brand logo
Upload method: Drag-and-drop file upload
Max file size: 2 MB

Build-A-Box
Box cover image
Upload method: Drag-and-drop file upload
Max dimensions: 800 × 400 px
Notes: Displayed on the storefront and Shopify product page. No strict file size limit is enforced, but smaller files are recommended for performance.

Journeys
Banner (desktop & mobile)
Upload method: Image URL
Recommended aspect ratio: 3:1
Optional: Banner link (click-through URL)

Referrals
Referral block – promotional image
Upload method: Drag-and-drop file upload
Recommended aspect ratio: 2:3
Max file size: 2 MB
