How to show each shopper's ring as the Shopify cart picture

How it works

At add to cart, the ring builder takes a square picture of the ring on white, from the same angle the 3D view opens at. Ring Facet saves it once to your store’s Files, because Shopify only shows cart pictures stored on Shopify, and attaches it to that ring’s cart line.

• Checkout: shows the ring as soon as the feature is on.
• Cart page, cart drawer and added-to-cart popup: drawn by your theme, so they need the Ring picture in cart app embed (one click and Save).
• Order confirmation email: drawn by your email template, so it needs a one-time update that Ring Facet prepares for you. It also lists every detail of the ring under its title.
• Staff New order email: the same one-time update adds the ring’s picture and all its details, so your team doesn’t need to open the order.
• View your design: both emails also link to the ring’s saved design on your store.

Each ring gets its own picture, so a cart with two different rings shows both. Other products keep their own photos everywhere.

Turn it on

1. In Shopify admin, open Apps → Ring Facet.
2. Under Ring picture in cart, click Turn on.
3. Approve Shopify’s request to let Ring Facet save files. Only rings that are added to a cart are saved, as ring-….jpg in Content → Files.
4. Build a ring, add it to the cart and go to checkout: it shows the ring you built.

To stop, click Turn off. The permission goes back to Shopify and new cart lines show the product photo again.

Show it on the cart page and cart drawer

1. In the same section of the Ring Facet app, click Turn on in your theme.
2. The theme editor opens with Ring picture in cart already switched on under App embeds. Click Save.
3. Add a ring to the cart and check the cart page and drawer.

App embeds belong to a theme. If you publish a different theme later, open its editor, choose App embeds and switch on Ring picture in cart there too.

The embed finds each ring’s cart line by the line’s ID, which Shopify themes such as Dawn and Horizon include in their cart. In a theme where a line can’t be matched, that line keeps the product photo; checkout and the email are unaffected.

Add the ring to the order confirmation email

Shopify sends the order confirmation from your store’s own email template, and Shopify doesn’t let apps edit email templates. Ring Facet prepares the update, and you paste it in:

1. In Shopify admin, go to Settings → Notifications → Customer notifications → Order confirmation and click Edit code.
2. Click in the code, select all of it (Cmd+A on a Mac, Ctrl+A on Windows) and copy it.
3. In the Ring Facet app, under Rings in your order emails, choose Customer order confirmation, paste it into the box and click Prepare my email.
4. Click Copy, go back to Edit code, select all, paste and click Save.
5. Place a test order with a newly built ring.

Under the ring’s title, the email then lists every option the shopper chose, one per line (setting, band, diamond, stone colours, metal, size, engraving and more), followed by a View your design link. The title itself stays as it was. Prepare my email only changes the lines that draw product pictures and adds those lines under ring titles: ring lines get the shopper’s ring, everything else keeps its photo. It runs in your browser, so your template isn’t sent anywhere, and running it again on a prepared template changes nothing. If your email has been heavily customised and doesn’t have Shopify’s usual picture lines, it says so and changes nothing, and your email keeps working as before.

Add ring details to your team’s New order email

Shopify’s staff New order email names a ring line only “Custom Ring”, so your team opens the order to see what to make. With the same one-time update, it shows the ring’s picture and, under the ring, every option the shopper chose: setting, band, diamond, carat, colour, clarity, stock number, certificate, measurements, metal, finish, ring size and engraving.

1. In Shopify admin, go to Settings → Notifications → Staff notifications → New order and click Edit code.
2. Select all the code and copy it.
3. In the Ring Facet app, under Rings in your order emails, choose Staff new order notification, paste the code and click Prepare my email.
4. Click Copy, paste it over everything in Edit code and click Save.

The ring details work for every Ring Facet order, even if Ring picture in cart is off. Rings added to a cart before you set this up don’t include them.

“View your design” link

Each ring added to a cart is saved as a design, like Save & Share does, and both prepared emails show a View your design link under the ring. It opens that exact ring in your ring builder, on your own store page, so the shopper and your team can see what was ordered.

• Opening the link never changes the order: any change the shopper makes there is a new design. How shoppers ask for changes after ordering is up to you; you can add your own wording around the link in Edit code, and change or translate the words “View your design”.
• The link shows only when it points to your own store (your primary domain or your .myshopify.com address).
• Saved designs are kept for 12 months, or until you delete that ring builder.
• Rings added to a cart before this was available have no link.

For theme developers: every ring’s cart line also carries the link as the private line item property _ringFacetDesignUrl. A theme can use it for an “Edit your design” link in the cart, for example {% if item.properties._ringFacetDesignUrl != blank %}<a href="{{ item.properties._ringFacetDesignUrl }}">Edit your design</a>{% endif %}. Editing adds a new ring to the cart; the old one stays until the shopper removes it. Shopify’s emails can’t read line item properties of a ring, which is why the emails use their own line.

Using an AI app

If you’ve connected an AI app to Ring Facet with the MCP connector (beta), ask it to show the ring picture in your cart and order emails. It walks you through the steps with ring_picture_setup_guide, and prepares your Order confirmation or staff New order email with prepare_order_email from the code you paste. Neither changes anything in your account: you still paste the prepared email into Shopify yourself. MCP setup

Good to know

• Rings added to a cart before you turned it on keep the product photo; new ones show the ring.
• Ring picture in cart is part of the Ring Facet app for Shopify. WooCommerce and website embeds aren’t covered.
• The same ring added again reuses its saved picture instead of saving a new file.
• Add to cart is never held up: if the picture or the design can’t be saved within a few seconds, the ring goes in without it.