Before you start
You need a Shopify store and a theme you can edit. There is no separate seeonwall.com account to create — installing the app sets everything up, and billing is handled by Shopify on your usual invoice. The free plan needs no card.
Install the app
Everything starts from the Shopify App Store listing.
- Open the seeonwall.com listing and choose Install.
- Shopify shows you the permissions the app needs — it reads your products and themes, and writes poster sizes back to your products.
- After you approve, the app opens straight into setup. There is nothing to download and no code to paste.
Choose how to set up
The first screen asks how you want to set up. Both ways save the same settings, and you can change your choice later.
- “Set it up step by step” asks one question on each screen and takes you through Steps 1 to 3 below. To change to the other way, use the link “Let us set it up for you” at the top of these steps.
- “Relax while we set up your visualizer” starts with “Reading your store”. The app reads your products, finds the wall art among them, and reads the unit, the sizes, your frames and which photo shows the clean artwork.
- Under “Pick a poster”, choose one of your posters and see it at its true size on a wall, as your shoppers will.
- “Continue to review” opens “Check what we found”: the posters that get the button, the unit, your frames and your photos. “Edit” opens the matching step.
- Nothing changes in your store until you click “Save and continue”. If one photo position does not suit all your products, the app then offers Auto setup, as in Step 3. Both ways continue at Step 4, and shoppers see the button after you add it to your theme.

The first screen: two ways to set up. 
Reading your store: what the app found, and one of your posters on a wall. 
Check what we found: nothing changes until you click Save and continue. Step 1 — Choose which products get the preview
The first question is the one only you can answer: which of your products belong on a wall. Posters and art do. Mugs and T-shirts don't.
- Every poster with a size — any product with a poster width and height shows the button. Best if your store is mostly art and posters.
- Selected collections or tags — only products in the collections you tick, or carrying one of the tags you enter. Best if you sell art alongside other things.
- Only products I turn on — nothing shows the button until you switch it on for that product. Most control, most work on a large catalogue.
- Whichever you pick, you can change it later, and any single product can always be forced on or off on its own.
If you choose Selected collections or tags, tick at least one collection or enter a tag before continuing — otherwise the button has nothing to appear on. Separate several tags with commas.

Step 1: three ways to decide which products shoppers can preview. 
Choosing “Selected collections or tags” reveals your collections and a tag field. Step 2 — Give your posters a size
A wall preview has to know how big the poster is. Most poster stores already put the size in the variant name, so this is usually one click.
- First tell us how to read sizes with no unit. If a variant is called “30x40”, is that centimetres or inches? If a unit is already saved and you pick the other one, the app asks first, because your live store then reads every size without a unit in the new one: click Change unit.
- Then choose Scan catalog for sizes. seeonwall.com reads every variant name and shows you exactly what it found before changing anything.
- Names like “50x70 cm”, “A3”, “18x24 inches” and “21 x 29,7 cm” are all recognised. Names that already include a unit are detected regardless of the setting above.
- Review the list, untick anything that looks wrong, and choose Apply. Sizes that are already set are never overwritten.
- Anything that looks implausible for a wall poster is flagged and left unticked, so a wrong unit can't be applied by accident.
Sizes in inches are the one case worth double-checking. A variant called “8x10” with the unit set to centimetres becomes a postcard-sized preview. If your sizes are in inches, set that before scanning.

Step 2: choose how unit-less names should be read, then scan. The scan lists every size it found before anything is written. Step 3 — Tell us where the print is
Only needed if your product photos are mockups — the print on a coloured background, or inside a frame. Skip it if your photos are the artwork itself.
- A mockup photo has the print sitting inside a bigger image. Previewed as-is, the whole photo is treated as the poster, so a 30x40 print looks noticeably smaller on the wall than it will be.
- If the gallery also has the print on its own, pick “Another photo shows the print” and enter its position — 2 for the second photo, and so on. This applies to the whole shop, and you can change it later under Products → Data sources.
- Otherwise pick “The photos are mockups”. The guide then adds a step, Auto setup: the app analyses the images of your products, picks the one that shows the artwork and marks where the artwork sits in it.
- Nothing changes on a product until you approve its result: choose Approve, Reject or Adjust on each one. When a product shows the same mockup as one the app already analysed, it is set up from that result. You can also continue and do this later on the Products page.
- Products that already have a poster image are listed but not selected.
If your photos are the artwork edge to edge, pick “The photo is the artwork” and move on — nothing to do.

Step 3 asks one question. If another photo already shows the print, entering its position is all it takes. 
Auto setup: the app finds the artwork in each mockup and shows the results for approval. 
Each result waits for your approval. Nothing is written to a product until you approve it. Step 4 — Add the button to your store
Two changes in your theme. Each opens the theme editor; press Save there and come back — the app rechecks itself automatically.
- Turn on seeonwall.com in your theme. This loads the preview once across your whole store, and is what makes the button work anywhere.
- Add the button to your product page. This places “See on wall” next to your Add to cart button.
- Each row turns into a tick once the app can see the change. If a tick doesn't appear, choose Check again.
- Once both are ticked, the rows switch to Open so you can jump back into the theme editor to adjust styling.
- Using an older theme that doesn't support app blocks? Turn on the app embed and use automatic placement instead — see below.
Shopify's theme editor doesn't save on its own. If a step won't tick, the usual reason is that Save wasn't pressed in the editor.

Step 4: two theme changes, each ticked once the app can see it. Open jumps back into the theme editor. Step 5 — What do you want from seeonwall.com?
Four features that stay off until you turn them on. Each one saves as soon as you change it.
- Let shoppers hang several artworks on one wall — shoppers add more of your posters to their wall in the preview and arrange them side by side: up to 2, 3, 5 or 8 on each wall, by plan.
- 3D and AR — choose On to let shoppers turn the poster in its frame in 3D and see it on their own wall in AR on a phone, or 3D and AR only to make the button open 3D and AR directly. On the Free plan, AR is a 14-day trial that starts when you turn it on. With On for chosen products, only the products where you choose Show 3D and AR for this poster in the product editor of the app show them.
- Show 3D rooms in the room picker — shoppers can choose a 3D room, turn and zoom the view and change the colour of the wall. On the Free and Basic plans, 3D rooms are a 14-day trial that starts when you turn them on.
- Count add-to-cart and orders — counts how often shoppers add a poster to the cart and order it, grouped by how far they got in the preview. When you tick it, Shopify asks you to let the app read your orders. We read the line items and refunds, and nothing about the customer.
- Leave a feature off to keep it off. You can change them later: gallery walls, 3D and AR, and 3D rooms on the Storefront tab, order analytics on the Analytics tab.

Step 5: gallery walls, 3D and AR, 3D rooms and order analytics. Step 6 — You're set up
The last screen recaps every decision so you can see anything left unfinished.
- Which products show the button, whether your posters have sizes, and whether the button is in your theme.
- Anything not ticked can be picked up later from the Storefront tab — nothing is lost by finishing here.
- Go to my posters takes you to your catalogue, where you can check individual products.

Step 6: the recap. Everything ticked means shoppers can preview your posters.
After setup
The wizard runs once. These are the screens you'll come back to.
Overview
Once setup is done, the app opens on Overview. It shows on how many products the button is live, the use of your plan, which features are on, and the activity of the last 30 days.
- Products ready says on how many products the button is live, with a bar and the counts: live, blocked, need review, hidden. The counts come from your last visit to Products. The main button goes to the next task: Check storefront while the storefront setup needs attention, then Fix next product, then Preview a product.
- Poster views / month and Photo uploads / month show your use and the limit of your plan. Plan shows your plan, and Plan & usage opens the detail.
- Features shows a light for Gallery walls, 3D and AR and 3D rooms: green when the feature is on, yellow when it is on in a free trial, red when it is off or not in your plan. Open the Storefront tab opens the settings.
- Last 30 days shows Previews started, Poster placed, Poster views and Sessions with a share link. View analytics opens the detail.

Overview: products ready, plan use, features and the last 30 days. Storefront
The Storefront tab holds your theme setup and the settings of the preview that shoppers see.
- Theme setup shows whether the app embed and the button are in your theme. Re-check setup checks again, and Run setup again opens the setup guide.
- Where shoppers can preview covers your product pages and the Fast wall preview: choose the product listings that show the preview icon, and see how many poster views are left.
- Preview settings holds Add to cart in the preview, Gallery walls, 3D and AR, 3D rooms and Image fit in the preview. Branding and access holds Visualizer accent colour, Watermark on shared previews and Allowed domains. The accent colour and the watermark need the Ultra plan.

Storefront: theme setup, where shoppers can preview, and the preview settings. Your posters
The Products tab lists every product with its preview status, so you can see at a glance what shoppers can and can't preview.
- Live means the button appears. No size means the product has no poster dimensions yet. Hidden means something excludes it: it is set to Never show, it is not in your collections or tags, or it is not turned on. The badge on the row says which.
- The counters summarise the products loaded so far. The tabs — All, Live, No size, Hidden, Needs attention — narrow the list, and the search icon finds products by title, collection or tag.
- Turn off and Turn on override the shop-wide setting for a single product. On a product with no size, Check why opens the button check on the Storefront tab, and Set size opens the editor. Turn off hides a product with no size, for example a product that is not art, and takes it out of Needs attention.
- Edit opens a product's sizes and preview image without leaving the app, and the eye icon previews it as a shopper would. An “Artwork area” tag marks products whose print area is set.
- “Scan catalog for sizes” sits at the top. The “Set poster images” menu next to it holds “Auto setup”, “Set artwork area for mockups” and “Upload artwork files”. The unit used for variant names that have none (“Sizes without a unit are in”) sits next to the “Your posters” heading and applies shop-wide.

Every product with its status, and the setting that decides where the button appears. Preview fixes
When the preview of a product may show more than the artwork, or the app cannot confirm that the artwork is straight, the banner “Some products look wrong in the preview” appears on the Products tab. Review products opens this list.
- Apply suggested area sets the artwork area that the app found, when it found one.
- Open product opens the product, so you can draw the area yourself or choose another image.
- Ignore removes the product from the list when its image is correct as it is. The app asks first, because an ignored product does not come back: click Ignore again to confirm.

Preview fixes: each product, what is wrong with its image, and what you can do. Fixing one product on its own
Every product can be edited by hand from the Products tab — useful for the odd photo that doesn't match your usual template.
- Poster size is the size shoppers see on their wall. Leave both fields empty to remove it and hide the button.
- “Wall preview for this product” overrides the shop-wide setting: follow the shop setting, always show, or never show.
- Tick “Sold with a mat” if the poster comes with a passe-partout. The preview draws the mat inside the poster size.
- Sizes per variant come from the variant names. Enter a size only to correct one, or switch to “Enter the sizes here” to list the sizes yourself.
- Further down, under “Poster image & artwork area”, pick the image the preview uses and drag the box around the print. Preview shows the shopper view, and Save & next issue moves on to the next product that needs work.
Changing the poster size and the artwork area together is fine — the proportions check compares the two and warns you if the box would stretch the print.

Poster size, the per-product override, the mat and the sizes per variant, all in one place. Your frames
If you sell frames, name them under Products → Frames. Shoppers then pick your frames in the preview instead of six generic colours.
- Each frame has a name, a width and a colour. Shoppers see the name in the preview.
- Read frames from products takes frame names from your product options. Each one starts as a draft, and shoppers can't see it until you give it a width — we never guess a physical size.
- Open previews with this makes one frame the default, so every preview starts with it.
- Remove, in the form that Edit opens, takes a frame out of the preview. Press Save frames when you're done. When you remove or rename a frame, the app asks first, because products that offer it lose it: click Save anyway, then pick the frames again on those products.
If you typed a frame name into a seeonwall.com button in your theme editor, update it there too whenever you rename the frame here.

Frames: your own frames, each with a width and a colour, and one chosen as the default. Using your own metafields
If your products already store their size or a print file in metafields of your own, point seeonwall.com at them under Products → Data sources.
- Width and height can come from any dimension, integer or decimal metafield. Plain numbers are read in your shop's size unit.
- The poster image can come from a file metafield — a clean print file that never appears in the product's images.
- “Gallery image for the preview” picks the product photo to use when there is no poster image: the first, the last, one at a set position, or the first that matches the poster's proportions.
- seeonwall.com's own metafields are always the fallback, so products without your metafields keep working.

Data sources: map your own metafields, and choose which gallery photo the preview uses. Settings
The Settings tab holds your account details, the app's language and your email notifications.
- Account shows your shop domain. Your account ID is on the Support tab — include both when you contact support.
- Preferred language sets the language of the app.
- Email notifications tell you when a preview, photo, view or download limit is reached, and when 80% of your monthly poster views are used. Each box saves as soon as you change it, and View all notifications opens the full list.

Settings: account details, language and email notifications. Plan & usage
The Plan & usage tab shows your plan and how much of its limits you have used.
- Subscription shows your plan, its status and that billing goes through Shopify. Change plan opens your plan page in Shopify, where you can upgrade, downgrade or cancel at any time.
- Usage this hour and month shows previews started, photo uploads, poster views and downloads against your plan's limits. Most counters reset every hour; the monthly photo-upload and poster-view counters reset at the start of each month.
- Limit history shows the last time each usage type hit its hourly limit, and your count at that moment. Until a limit is hit, it says No limit reached yet.

Plan & usage: your subscription, current usage and limit history. Making the button match your theme
The button block has its own settings in the theme editor, so it can be styled to look like the rest of your store.
- Background, text and border colours, plus corner radius.
- Button CSS class — paste your theme's own button classes here and the button inherits them, matching Add to cart exactly.
- Find those class names by inspecting your theme's buy button in your browser.
- “Show the variant size check” lists, in the theme editor only, every variant with the size it detected and whether the preview can add it to the cart. Turn it off once you have checked.

The button block's settings, in Shopify's theme editor. App embed settings and automatic placement
The app embed carries the store-wide settings — and an option that places the button for you.
- Add the button automatically puts “See on wall” below Add to cart without you placing a block.
- This is the answer for older themes that don't support app blocks at all.
- Language can follow your storefront's locale or be pinned to one language.
- Colours set here apply only to the button that Add the button automatically places; a button block uses its own settings.
If you've already added the button block to your product template, that one wins and automatic placement is ignored — so you'll never end up with two buttons.

The app embed, including automatic button placement. If the button doesn't appear
The Storefront tab has a check that walks the same path the storefront does and tells you which step fails.
- Open Storefront and find “Why isn't my button showing?”, then pick the product in question — or click Check why on a product in the Products list.
- It checks the app embed, the button block, the poster width and height, and whether your activation setting includes that product.
- The first failing step is named directly, so you know what to fix rather than guessing.
- For multi-variant products it also reports how many variants resolved a size, which catches sizes missing from a few variant names.