The Ring Builder flow
The whole customer journey from choosing a diamond to a composed ring in the cart, and what NivoSync does at each hand-off.
The builder is a three-step journey held together by a session. Understanding where that session is written and read explains most of the behaviour you will see.
The journey
1. Choose a diamond
The shopper filters the diamond grid and picks a stone. There are two ways in:
- From the grid. With the loop's card action set to Select for the ring, the card's button stores the diamond and moves the shopper to the settings step.
- From the diamond page. The single diamond page carries the same action, for shoppers who wanted to read the specs first.
Either way the chosen diamond is written to the Ring Builder session, and the stepper marks step 1 complete.
2. Choose a setting
The settings step shows a banner with the diamond just chosen and a link to change it, then a grid of ring settings.
With Only compatible settings on, that grid is restricted to settings that fit the diamond's shape — a setting head cut for a round stone is not offered for an emerald. This is the core's rule; the addon renders it rather than reimplementing it.
The shopper opens a setting and lands on its page.
3. Complete the ring
The setting page is where the journey closes. The buy panel shows:
- The setting, with its metal, band style and ring size options.
- The diamond already chosen, with its price.
- The two prices summed — this is the number the shopper acts on.
- Add to cart for the complete ring, and/or Book a consultation.
Which of those two buttons appears is decided by your NivoSync settings, not by the addon. See Dashboard gates.
What lands in the cart
Adding the ring to the cart creates one line item, not two. It carries:
- The setting product and the specific variation (metal, band style, ring size).
- The diamond, with its shape, carat, colour and clarity.
- The ring size the shopper picked.
- The composed price: setting variation + diamond.
The cart shows each attribute once. The price shown in the buy panel, in the cart and at checkout is the same number.
After a booking
If the shopper books a consultation instead of buying, you usually want the next session to start clean rather than inheriting a half-built ring.
The Single Setting Panel has two controls for that:
- Reset the Ring Builder after booking — clears the chosen diamond and setting once the booking is confirmed.
- After booking, go to — where to send the shopper afterwards. Empty means the homepage.
The redirect happens a couple of seconds after the confirmation appears, so the shopper reads it first.
The guards you will notice
The core protects the journey's integrity, and you will see this while testing:
- Jumping ahead does not work. Opening the complete step with an empty session redirects to the diamond step, and the same for the settings step without a diamond. This is deliberate — a summary of nothing is not a page worth showing.
- Going back does. Completed steps in the stepper link backwards, so a shopper can change their diamond. Upcoming steps are never clickable, because the core would bounce the jump anyway.