3D Jewelry Designer

Connect Shopify and photograph your catalogue

In Dashboard → Embeds, one-click Connect Shopify links your store by OAuth, and orders flow back through webhooks as attributed revenue. Dashboard → Shopify then matches every variant to your ring catalogue, renders a photograph for each combination, and Bulk update writes the photo URLs into your product CSV. Copy the Ring Builder 3D section into any theme to place a builder.

3D Jewelry Designer11 min read

Connect your store

From the Basic plan, one-click Connect Shopify in Dashboard → Embeds links your store by OAuth. Orders then flow back through secure webhooks so the sales your builders drove show up as attributed revenue, with no theme editing needed.

When a builder takes its prices from your Shopify products (Pricing → My Shopify products), it keeps up with your store on its own. A change to a product's price, title, picture or stock reaches the builder within a few minutes, and a deleted product leaves it. Each night the builder syncs your products again, which also picks up variants you added and SKUs you changed. A store connected before this keeps working; its first nightly sync turns the updates on.

Photograph your whole catalogue once

In Dashboard → Shopify:

  • Store connects your shop.
  • Products matches every variant to your catalogue by its type (search it by SKU or product name, and it tells you exactly why any did not match, with a one-click wording fix). Rings match your ring designs as always; a ring variant whose options never name a prong style or a carat takes the design's default prong style (or the only one its shape is made in) and its smallest carat. A wedding band matches its band alone, and earrings, pendants, necklaces, bracelets and other pieces match the design in the Jewelry catalog whose SKU code starts their SKU, in the variant's metal. The ring builder uses your rings, and a matched wedding band: its name and price show on the matching band button of your product pages' 3D view, and a builder that takes your Shopify prices sells the band at its price.
  • Where your products are lists what Products reads: pick collections from your store's own list (search it by name, with each one's product count), or choose Every product in my store. Each one can have its own SKU starts with, so only that collection's SKUs starting with it are read. One Sync now reads them all together, up to 20, and a product in two collections is read once. A store set up with one prefix and one collection keeps them as its first entry. Each entry can also have a Type, for products whose own Shopify product type is blank: a collection of wedding bands, say. With two or more collections, each has its own sync button: it adds and updates that collection's products and removes nothing, so you can bring in a new Earrings collection without re-reading every ring. Its result shows under the list. A full Sync now still removes what your store took down, and recounts every type.
  • By type: a product's type is its Shopify product type (Stud Earrings, Wedding Bands, Bangles), else its entry's Type; a blank or unknown type is read as a ring, as before. After a sync, the type bar (All, Rings, Wedding bands, Earrings, Pendants, Necklaces, Bracelets, Other pieces) shows how many of each matched. Pick a type to see its categories, its matched products and the SKUs of it that did not match, with why. If a sync matches no ring while other types match, your rings from the last sync are kept.
  • Photos renders each combination, shows every design with its picture, SKU and metal (searchable by name or SKU, and re-shootable one at a time or in bulk), names the environment and camera each shot is taken with, and keeps the library in step with your catalogue (Capture new rings when a design is added, Clean up when one is deleted; counts are in rings, matching the tiles below, and each button photographs only what it names).
  • Photos by type: once the catalogue holds wedding bands, earrings, pendants, necklaces, bracelets or other pieces, a type bar (All, Rings and each of those) sits above the counts. Each piece is photographed on its own in every metal, framed for its type: wedding bands and bangles standing like a ring, studs face-on, pendants and drop earrings hanging, necklaces and tennis bracelets laid flat. Only wedding bands take your engraving. The counts, Capture new and the tiles follow the type you pick; Rings is where the tab opens. Under a type with two or more categories, chips narrow it further: pick Stud earrings and only those are counted, captured and listed. Clean up always checks every type, so a photograph of one type is never offered for deletion because you were looking at another.

Bulk update

Bulk update takes your Shopify product CSV, lets you confirm which column is the SKU and which one the photo URL should be written into (auto-detected, so a standard export is one click), shows the rows it filled, and hands the sheet back. Export all products so every variant is its own row, since it is the Metal Color and Shape on each row that decide which photo it gets.

The sheet's Type column decides how each row is read. Rings are matched as always. A wedding band, earring, pendant, necklace, bracelet or other piece is matched to the design in the Jewelry catalog whose SKU code starts its SKU, and gets that design's photo in the row's metal and, with spec columns on, its own weight and stones. A piece's size option is never read as a ring size. When the sheet holds more than rings, the result shows a line per type, and a code that names no design is listed under its type. To fill only some of it, pick the types under Rows to fill, in your sheet's own Type words (Stud Earrings, Hoops): every other row is left exactly as it is.

How photographs are stored

Each photograph is stored as ONE file: the full-size image that goes to Shopify and shows here, in whichever format you pick under Photo settings → File. Re-shooting one replaces what was there rather than leaving the old file behind, and Remove extra sizes clears anything left over from before.

You can re-capture or delete a single design, the tiles you tick, or everything matching what the filter and search box are showing (Re-capture all and Delete all next to the filters). A run keeps going while you work in another tab, and closing the tab is safe: finished photos are stored and the next run resumes.

A large catalogue captures faster in several windows. Open the Photos tab in each window with its share at the end of the address (/dashboard/shopify?tab=photos&part=1/3, then part=2/3 and part=3/3; up to 16 parts). Each window photographs only its own rings and its button names its part, so no ring is shot twice.

Textured metals (brushed, hammered, sparkle and scratch finishes) are photographed with the same finish the builder shows, and a band and setting pair whose fit was fine-tuned in the catalogue is photographed with that adjustment, as the builder shows it. On a back/front, left/right ground the whole ring now casts the shadow, not only its stones. Photos taken before 8 October 2026 show the polished metal, the unadjusted fit or the stones-only shadow. They keep working and still count as photographed, and Bulk update tells you when a row was filled with one of them. Re-capture those designs, then run Bulk update or Update all images again so your products get the new photos.

If a green Recover banner appears above the counts, press it: those photographs are already on your NAS under an old name and it moves them back into place in minutes instead of re-rendering them. Nothing is deleted and no ring is re-shot.

Updating your Shopify products directly from 3JD is turned off for now, so per-variant Set variant image, Update all images and Push specs are greyed out. Photos and specs go through your product CSV sheet on Bulk update, which can also write exact weights and stone counts into their own columns; see Weight, stones and cost-based pricing.

Photo settings

A product photograph and a live configurator are two different pictures, so the uploader has its own look: Photo settings inside either uploader.

To set the angle, spin the ring in the preview until it looks right and press Use this view; six named shots (Hero ¾, Straight on, Profile, Top down, Raised gallery, Setting detail) give you a starting point, and exact degrees, tilt, zoom and lens live under Fine tuning.

Everything else (output size/shape/format, lighting, HDR per metal colour, ground, background, materials and engraving) either matches your builder or takes its own value, per field. Editing anything switches the profile on for you (with an Undo), since otherwise your changes would save but never apply.

Changing a photo setting is safe

A photograph is filed under the settings it was taken with (the backdrop, lighting and output size decide its folder, and the camera angle decides its file name), so a change files NEW photographs under a different name. Your existing ones are never touched, never deleted, and keep working: the grid and the Bulk update CSV both fall back to the nearest photograph that really exists, so every tile and every import row stays filled.

They also still count as photographed: changing a setting never moves a ring back into Not yet and never adds anything to your capture backlog. Re-shooting is always your choice: one tile, the tiles you tick, or Re-capture all beside the filters.

If you change your mind, the Photos tab offers a one-click way back (Put my camera back for an angle change, or Restore these settings / Switch to 2048px jpg for a folder change), with nothing to re-capture and no credits spent. And Use these re-files what you already have under the new setting instead; where the change was the gem material or the engraving it tells you how many rings it can put back, matched by band, head and metal.

Products in your store

When a ring goes to the cart, a builder can add it to your catalogue: a product for each new ring (Create a product for each ring), or a variant on a product you choose. It does so only with your yes: turn on Add products to my store on the Shopify app card in Dashboard → Shopify → Store. With it off, those rings go to checkout as a Shopify draft order, at the same price.

With it on, each ring's product carries its ring sizes as variants. A size is added the first time a shopper picks it, so your reports and stock work per size. Products made before keep their one variant, with the size on the order line.

A new ring's product gets its pictures from the shopper's own builder right after it is made: four views (front, three-quarter, profile and top), and the front view is also the picture of its variants, so the cart, the order and your admin show the ring. The 3D model follows when the ring's file is up to about 3 MB; a larger ring gets the pictures only. If the pictures never arrive (the page was closed first), the next shopper who adds the same ring sends them, three times at most. A product that already has pictures never gets a second set.

A builder that matches your own variants (Match an existing variant by SKU) sells a ring with a chosen diamond as two lines when this is on: the setting on your variant, and the diamond as a product of its own at its price, added together and removed together. A ring with an engraving charge as well, or a page whose script is older than ring-builder.js 2.13, goes to checkout as a draft order at the builder's total instead, as it does with this off.

A store connected before 26 October 2026 that has not chosen keeps what its builders were set to: a builder that creates products or adds variants goes on doing so, and one that matches your own variants never adds products.

Over the API: PATCH /api/public/integrations/shopify with { "catalogWrites": true }, or setShopifyCatalogWrites in GraphQL.

Any Shopify theme

Copy the Ring Builder 3D section (and its optional page template) into your theme, paste your embed ID in Theme settings, then Add section → Ring Builder 3D on any page. No variant id and no cart code: the builder resolves the line itself, and the section fires rmj:ringbuilder:added so your cart drawer can refresh.

The builder also notes your theme's colours and fonts, including fonts from Shopify's font library, so you can make a builder theme in your store's look (Match my store).

A 3D view on product pages

The Product 3D app block (theme editor → product template → Add block → Apps → Product 3D) takes a Media Only embed's ID and shows each product's own design, following the variant the shopper picks. Its Category setting reads the product's type, or set it to Ring or Wedding band: a wedding band never opens the ring that shares its number. The design is the product's rmj.design_slug metafield when it has one, else its SKU's leading code. When a ring's rmj.band_product metafield names its matching band's product, a link to that product shows once the shopper adds the band to the 3D view.

Photos and the catalogue sync never match a product whose type reads as a wedding band to a ring by its SKU, in the bulk sheet (its Type column) as in the sync.

Edit a ring from the cart

Each ring a builder adds to the cart carries two links on its line. Edit opens the ring again on the page the shopper built it on, with every choice in place. The builder's button then reads Update cart, and saving puts the changed ring in the cart in place of the old one, at the same quantity. View in 3D shows the ring on its own.

With the 3JD Shopify app, turn on Cart links in Theme settings → App embeds. The links appear under each ring's title on the cart page and in the cart drawer, and you can rename them there or leave View in 3D out.

Without the app, add this once before </body> in theme.liquid (it is also under the builder's Install & embed):

<script src="https://3djewelrydesigner.com/cart-links.js" defer></script>

A theme that draws its own links reads them from the line's hidden properties:

{%- if item.properties['_rmj_edit_url'] -%}
  <a href="{{ item.properties['_rmj_edit_url'] }}">Edit</a>
{%- endif -%}

Edit works on pages where the builder loads through ring-builder.js: the Ring builder app block and the Ring Builder 3D section both do. A ring and its band added together as a set have View in 3D, but no Edit link yet.

Related

Put your own design in the studio

Upload a file and see it rendered photoreal, ready to embed and, for a ring, to try on.