Product images / MERCHANT WORKFLOW
Should a Square Online Campaign Hero Be a Background Image or a Foreground Image?
Use a Square Online background image when the photograph mainly establishes the section's atmosphere behind text or other content. Use a non-background, or foreground, image when the product photograph is part of the section's primary information. Square documents separate controls and different size guidance for these roles: no more than 1000 pixels on the longest side for non-background images, and at least 2000 × 1000 pixels as a starting point for backgrounds.
Choose the image's responsibility
Square's site-editor help explicitly distinguishes non-background images, which form part of a section's content, from background images, which sit behind the content as part of the section's design.
This difference matters when a campaign photograph contains information the buyer must see. A decorative room photograph can tolerate some cropping around the edges. A photograph intended to prove the exact product shape, label, included quantity, or a critical feature needs a presentation where those details remain visible.
Do not assume that a wide image automatically belongs in the background. The deciding factor is its job, not its aspect ratio. A wide technical comparison may still need a foreground content role.
| Image role | Square guidance | Primary decision |
|---|---|---|
| Foreground | No more than 1000 px on longest side | Product remains part of primary content |
| Background | Try at least 2000 × 1000 px | Scene supports surrounding content |
These are Square's recommendations for the site editor, not universal product-image or marketplace requirements.
Use the correct section control
In Square Dashboard, open Online, then Website, then Edit site. Choose the intended page and add or select a section.
For a foreground image, use the section's Add image control. Square documents selecting the image and choosing Edit to adjust available options. The help also documents Revert to original and Replace.
For a background, open Customize, then Background, choose Image, and add the file. Square documents a background readability slider, zoom and straightening controls. For mobile, its instructions provide a Set image subject control for adjusting the background's focal point.
Save and publish the site before judging the live result. An editor preview and the public page are different states. The current documentation does not establish that every section offers identical layouts or controls; inspect the actual selected section.
Hypothetical ceramic-lamp campaign
Hypothetical exercise; no Square Online editor was used. A fictional merchant sells SKU LAMP-CLAY-01.
Asset lamp-room-wide.jpg is a proposed 2400 × 1200 background scene with the lamp on a side table and open space for a native headline. Asset lamp-product-front.jpg is a proposed 900 × 900 foreground identification photograph showing the complete shade, base, and power switch.
The merchant's campaign headline is a fictional native text field reading Meet the Clay Table Lamp. The wide scene is assigned a decorative background role; the clean product view is assigned a content role.
The proposed mobile review must check that the background crop does not create a misleading product fragment. The foreground image must remain recognizable without relying on the background.
| Asset | Proposed control | Expected condition | Actual observation |
|---|---|---|---|
| lamp-room-wide.jpg | Customize > Background | Scene supports headline | Not configured |
| lamp-product-front.jpg | Add image | Complete lamp visible | Not configured |
Correct the failing role rather than regenerating everything
If the background crop removes the lamp from the mobile scene, inspect the documented Set image subject control and the section's background presentation. If the scene cannot survive the intended crop, choose a more suitable composition rather than distorting the product.
If the foreground photograph is too small or hides the switch, investigate its content slot, source crop, and actual displayed size. A background readability slider does not repair a foreground product-detail problem.
If the headline becomes unreadable against the scene, adjust the background readability treatment or choose a less busy source. Keep the essential text as native page content instead of baking it into an unreviewed image.
For responsive source-selection issues, see the art-direction guide. For choosing the correct placement, see the image-role guide.
CartVisual can prepare candidate product and campaign images but does not configure Square Online sections or publish the website.
Use the example with your own product records
The filled records are hypothetical editorial examples. The entry-template row is for your own files, settings and observations; it does not connect to another application.
| Fictional SKU | File | Image role | Proposed dimensions | Expected visual condition | Actual desktop observation | Actual mobile observation | Next action |
|---|---|---|---|---|---|---|---|
| LAMP-CLAY-01 | lamp-room-wide.jpg | Background | 2400 × 1200 | Headline readable; scene coherent | Not inspected | Not inspected | Check subject and readability |
| LAMP-CLAY-01 | lamp-product-front.jpg | Foreground | 900 × 900 | Complete product and switch visible | Not inspected | Not inspected | Check content image slot |
What the sources establish
- Square Support — Add images and backgrounds to your online store: Verified background/foreground roles, file formats, size recommendations, section controls, background readability adjustments, mobile focal-point control, and publication step.
Sources and further reading
Recorded source-review dates are listed individually below. An undated source does not inherit the article’s publication date. Software and platform rules can change; check the current original before acting.
- Square Support — Add images and backgrounds to your online store · Review date not separately recorded
Frequently asked questions
Does Square recommend the same pixel dimensions for foreground and background images?
No. Its site-editor help gives different recommendations: no more than 1000 pixels on the longest side for foreground images and at least 2000 × 1000 pixels for backgrounds.
Can I adjust a background's focal point for mobile?
Square documents Set image subject for background images. Check whether the control is available in the selected section.
YOUR NEXT CAMPAIGN
Create assets from a clear source
Bring your reviewed source photo or brand brief to CartVisual. Check the current tools, account access and credits before generating, then compare every result with your source.
Create a CartVisual account Open the workspace Check access and credits