Help
Mercurio: Poster & Art in AR
Customers see your poster on their own wall in augmented reality, in its real size and with the frame they pick. No 3D files needed.
- Get started
- Switch on in your theme
- Products and motif
- Sizes and frames
- Buttons and AR view
- AR on phones and computers
- Add to cart from AR
- Products that are not posters
- Plans
- Questions
Get started
- Install the app from the Shopify App Store and open it in your admin. A short guided setup opens.
- Your plan: start with Free or try a paid plan for 14 days.
- Your posters: the app reads your products, recognises sizes and frames and finds the poster in each first product picture. You can move every cut later.
- Buttons: choose where customers find AR: a small button on the product picture, a button under
Add to cart, or both. - Switch on in your theme: one click opens the theme editor, see below.
- Open a product in your store. On a phone, tap
View on your wall. On a computer the button shows the 3D poster and a QR code for the phone.
The app changes no theme files. Your progress is shown under Overview → Setup.
Switch on in your theme
Shopify asks you to switch app buttons on yourself. In the setup or on the overview, click Switch on in theme: the theme editor opens with App embeds and AR poster buttons already switched on. Press Save at the top right of the theme editor and come back to the app tab; the status updates by itself.
The app embed places both buttons on every product page with AR. In the theme editor you can also change the button texts, the corner of the picture button, the button style and the spacing for this theme. Empty fields and From the app use the settings from the app.
Want the button somewhere else? Add the AR poster button block to your product page in the theme editor (Add block → Apps). As soon as the block is on the page, the automatic button under Add to cart steps aside, so customers see one button only.
Products and motif
The 3D poster is made from your product picture. The app searches the first picture for the edges of the poster, also in a room photo or a framed mockup, and cuts it to the print format. If no clear edge is found, the whole picture is used, which is right for flat motif images.
To check or change a cut, open Products and click Edit on a product:
- Pick another product picture as the source.
- Drag an edge to cut, drag inside to move. Opposite sides move together; tick
Cut each side on its ownfor uneven cuts. A loupe shows the edge while you cut. Back to the automatic cutundoes your changes.- The 3D preview next to it shows the poster as it hangs on the wall, in every size and frame.
The switch on each product card turns AR on or off for that product. Moving the cut by hand is part of the paid plans.
Sizes and frames
Sizes come from the product's size option, for example Size with values like 50 x 70 cm, 50x70, A2 or 18 x 24 in. Centimetres, millimetres, inches and paper formats (A0 to A6, B0 to B5) are read in any common spelling. Values without a unit follow your store's unit system. A landscape motif hangs 50 x 70 cm as 70 x 50 cm.
Frames come from the frame option, for example Frame with No frame, Oak or Black. Each value gets a frame style that decides the colour of the frame in 3D. Frames are 20 mm wide and deep; posters without a frame hang as paper.
Products without a size option show up under the filter Need sizes. On the Grow and Scale plans you can set sizes and frames by hand (Set sizes by hand instead); Add to cart then takes the variant the customer picked on the page.
Buttons and AR view
Under Buttons and AR view you set, with a live preview for phone and desktop:
- On the product picture: show the button and pick the corner.
- Under Add to cart: show the button, its style (outline, filled, text link) and position (above or under
Add to cart, between the buy buttons, or belowBuy it now). - On computers: show the buttons on computers too. They open the 3D model with a QR code to the phone.
- Texts and colours (Starter and up): button texts, button colour, text colour and corner radius. Empty texts use ours, in the language of your store.
- AR view: let customers switch size and frame, show
Add to cartwith the price, the QR code, and the language of the AR view.
The storefront speaks English, German, French, Spanish, Italian, Dutch, Portuguese and Swedish.
AR on phones and computers
- iPhone and iPad:
Place it on your wallopens Apple's AR Quick Look. Customers point the camera at a wall and the poster appears there in its real size. - Android: AR opens in Google's Scene Viewer (or WebXR in Chrome). It needs a phone with Google Play Services for AR. On phones without AR the customer can still turn the poster in 3D, and the AR view says so.
- Computer: the button opens the poster in 3D to turn and zoom.
Open on your phoneshows a QR code; scanning it opens AR on the phone in the same size and frame.
The scale is fixed, so customers cannot accidentally resize the poster: 50 x 70 cm stays 50 x 70 cm on the wall.
Add to cart from AR
On the Grow and Scale plans, the AR view shows the price and an Add to cart button for the size and frame on screen. On iPhone, Quick Look also shows a banner with the title, size and frame, price and Add to cart, so customers can buy without leaving AR. Android's Scene Viewer has no such banner: customers close AR and tap Add to cart in the AR view. Sold-out variants show Sold out instead and cannot be added.
Products that are not posters
Stores often sell more than posters, for example candles or gift cards. On the Products page your product types appear as chips with their number of products. Click a type to leave it out: its products are hidden in the app and never set up. Click it again to bring the type back; products that had AR stay off until you switch them on.
Products that may not be posters, such as a size under 10 cm or an option like Color or Scent, get a Check hint. You can switch AR off, leave out the type, or confirm It is a poster. The automatic setup skips these products; you can still set them up one by one.
Plans
| Plan | Price | Products with AR | Highlights |
|---|---|---|---|
| Free | $0 | 10 | AR on product pages, QR code for computers, motif cut automatically, small watermark |
| Starter | $14.99 / month or $149.99 / year | 250 | No watermark, size and frame choice in AR, cut adjustable by hand, your button texts and colours, insights (AR views per product) |
| Grow | $29.99 / month or $299.99 / year | 3,000 | Everything in Starter, add to cart from the AR view, sizes and frames for any product |
| Scale | $99.99 / month or $999.99 / year | Unlimited | Everything in Grow, priority support |
Every paid plan can be tried free for 14 days, once per store. Yearly plans cost the same as 10 months. Shopify bills the plan on your Shopify invoice. When you move to a lower plan, nothing is deleted: products beyond the limit lose their AR buttons until you upgrade again.
Questions
Which phones can show AR?
iPhones and iPads with iOS 12 or later (AR Quick Look, in Safari and most other browsers), and Android phones that support Google Play Services for AR (ARCore). Most phones from the last few years qualify. On other phones the customer sees the poster in 3D instead.
Why does a product have no AR button?
Check these in order: the app embed AR poster buttons is switched on in your live theme; the product is switched on under Products and shows Live; it has a readable size (filter Need sizes); its type is not left out; your plan's product limit is not reached. On computers the buttons only show when Show the buttons on computers too is on.
The poster hangs too big or too small.
The size comes from the variant option. Open the product in the app and check the sizes it found. If a value was read wrongly, write it in a common form such as 50 x 70 cm, or set the sizes by hand.
The cut shows part of the room or the frame.
Open the product under Products, pick the picture that shows the print best (a flat motif image works best) and drag the edges to the print. Save, and the AR view uses the new cut right away.
Two AR buttons on the product page?
If you placed the AR poster button block yourself, the automatic button steps aside on its own. If you still see two, check that only one copy of the app embed is switched on under App embeds.
What about privacy?
The camera image never leaves the customer's device: AR runs in the phone's own AR viewer. The app stores no customer data. Insights count AR views, AR starts and carts per product anonymously: no cookies, no personal data.
Does the app change my theme?
No. The buttons come from a Shopify app embed and an optional app block. Switching the embed off or uninstalling the app removes them completely.
What happens when I uninstall?
The AR buttons disappear and the plan ends. All app data for your store is deleted 48 hours after uninstalling. If you reinstall before that, your cuts and settings are still there.
Contact
Write to hello@mercuriolabs.app. We usually answer within one working day.