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

  1. Install the app from the Shopify App Store and open it in your admin. A short guided setup opens.
  2. Your plan: start with Free or try a paid plan for 14 days.
  3. 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.
  4. Buttons: choose where customers find AR: a small button on the product picture, a button under Add to cart, or both.
  5. Switch on in your theme: one click opens the theme editor, see below.
  6. 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 own for uneven cuts. A loupe shows the edge while you cut.
  • Back to the automatic cut undoes 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 below Buy 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 cart with 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 wall opens 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 phone shows 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

PlanPriceProducts with ARHighlights
Free$010AR on product pages, QR code for computers, motif cut automatically, small watermark
Starter$14.99 / month or $149.99 / year250No 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 / year3,000Everything in Starter, add to cart from the AR view, sizes and frames for any product
Scale$99.99 / month or $999.99 / yearUnlimitedEverything 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.