Skip to main content

Nivoda Connect Installation Guide

Updated
Nivoda Connect β€” Installation & Setup Guide
Official Documentation

Nivoda Connect
Installation & Setup Guide

Your complete step-by-step guide to setting up Nivoda Connect on your Shopify store β€” Diamonds, Gemstones, Ring Builder & more.

🌍 World's Largest Diamond Marketplace⚑ Go Live in MinutesπŸ’Ž Built for Jewellers

April 2026 Β· Version 3.0 Β· Questions? tech@nivoda.com

Table of Contents
1 What is Nivoda Connect?2 Before You Begin3 Add Diamonds to Your Store4 Add Gemstones5 Add Fancy Coloured Diamonds6 Set Up the Ring Builder7 The "Add Diamond" Button8 Configure Your Settings9 Set Up Discounts10 Shopify Setup for High-Value Jewellery11 Need Help?
1

What is Nivoda Connect?

Nivoda Connect is the official Shopify app that plugs the world's largest diamond, gemstone and ring catalogue directly into your store. Customers browse live, real-time inventory β€” you manage nothing manually.

Feature Starter Plan β€” Free Pro Plan β€” $199/mo
White & Lab-Grown Diamonds Limited shapes, colours & carats Unlimited selection
Fancy Coloured Diamonds Limited selection Unlimited selection
Gemstones Limited selection Unlimited selection
Live Inventory & Pricing βœ“ βœ“
Ring Builder (Ring Studio) β€” βœ“
Discount Configuration β€” βœ“
Certificate Display β€” βœ“
Order & Fulfilment Automation β€” βœ“
1:1 Onboarding Support β€” βœ“
30-Day Free Trial β€” βœ“
β„ΉPro plan customers receive 1:1 onboarding support. Contact tech@nivoda.com or your Technical Account Manager to book a walkthrough.
2

Before You Begin

What You'll Need
Β·
A Shopify store (any plan)
Β·
A verified Nivoda account β€” sign up free at nivoda.com
Β·
A Shopify theme that supports App Blocks (most modern themes do)
⚠Use the same email for your Shopify store and your Nivoda account. You must be verified on Nivoda before all features unlock.
Check Theme Compatibility
1
Check "Create Template" exists
Online Store β†’ Themes β†’ Customize β†’ Top dropdown β†’ Pages β€” confirm Create template appears
2
Check App Blocks are available
Inside a page template β†’ Template section β†’ Add section β€” confirm you can see Apps and Nivoda Connect options
Compatible Themes
Sense (Free)Dawn (Free)Monaco (Paid)Impulse (Paid)Stiletto (Paid)Any App Block-compatible theme
β„ΉGo to the Shopify Theme Store and filter by "Jewellery & Accessories" to find brand-appropriate themes.
3

Add Diamonds to Your Store

β–Ά Part 1 β€” How to Install & Set Up Nivoda Connect

Create a dedicated page template and add the Diamond Feed block. We recommend a new template rather than editing your homepage.

1
Open Theme Editor
Online Store β†’ Themes β†’ Customize on your active theme
2
Create a New Template
Top dropdown β†’ Pages β†’ Create template β€” name it e.g. diamonds
3
Add the Diamond Feed Block
Left panel β†’ Add block/section β†’ Apps β€” search for and select Feed (white/lab-grown diamonds). One block per template only.
4
Customise the Feed
Adjust filters and display settings in the right panel. Starter Plan: shapes, carats & colours are pre-set.
5
Save & Exit the Theme Editor
Click Save (top right) before closing
6
Create a New Store Page
Online Store β†’ Pages β†’ Add page β€” title it e.g. All Diamonds
7
Assign Your Template
Right panel β†’ Template dropdown β†’ select diamonds β†’ Click Save β€” your diamond page is live!
Certificate Types
Diamonds
GIAIGIHRDEGL
Gemstones
GIAIGIHRDEGLGSIGRSCDCOTHER
⚠No spaces between commas when entering certificates. Correct: GIA,IGI,HRD β€” Not: GIA, IGI, HRD
β„ΉAll filter parameters are stored in the page URL. You can bookmark or share a specific filtered view β€” e.g. a curated page showing only 1ct+ round GIA naturals β€” and link to it directly from your menu or campaign.
β„ΉTo exclude specific suppliers from your feed, go to your Nivoda account β†’ Feed Center β†’ manage your supplier list.
4

Add Gemstones to Your Store

β–Ά Part 2 β€” How to Set Up Gemstones on Nivoda Connect

Follow exactly the same steps as Section 3, with two differences: choose the Gemstone Feed block and name your template gemstones.

1
Open Theme Editor
Online Store β†’ Themes β†’ Customize
2
Create Template
Top dropdown β†’ Pages β†’ Create template β†’ name it gemstones
3
Add the Gemstone Feed Block
Left panel β†’ Add block/section β†’ Apps β€” search and select Gemstone Feed. Certs: GIA, IGI, HRD, EGL, GSI, GRS, CDC, OTHER
4
Customise the Feed
Adjust gemstone type, certificates and display in the right panel. Starter Plan: gemstone type is pre-set.
5
Save & Exit
Click Save before closing
6
Create a New Store Page
Online Store β†’ Pages β†’ Add page β†’ title e.g. Gemstone Collection
7
Assign Template
Right panel β†’ Template β†’ select gemstones β†’ Save
5

Add Fancy Coloured Diamonds

β–Ά Part 3 β€” How to Set Up Fancy Diamonds on Nivoda Connect

Same process as Sections 3 & 4 β€” choose the Feed Fancy block and name your template fancy-diamonds. Filters are tailored to colour, intensity and shape.

1
Open Theme Editor
Online Store β†’ Themes β†’ Customize
2
Create Template
Top dropdown β†’ Pages β†’ Create template β†’ name it fancy-diamonds
3
Add the Feed Fancy Block
Left panel β†’ Apps β†’ search and select Feed Fancy. Certs: GIA, IGI, HRD, EGL
4
Customise the Feed
Adjust colour, intensity, shape & carat in the right panel. Starter Plan: filters are pre-set.
5
Save & Exit
Click Save before closing
6
Create a New Store Page
Online Store β†’ Pages β†’ Add page β†’ title e.g. Fancy Coloured Diamonds
7
Assign Template
Right panel β†’ Template β†’ select fancy-diamonds β†’ Save
6

Set Up the Ring Builder (Ring Studio)

πŸ’ŽPRO PLAN ONLY β€” Ring Builder requires the Pro Plan ($199/month). Upgrade within the Nivoda Connect app.
β–Ά Part 4 β€” How to Set Up the Ring Builder on Nivoda Connect
β„ΉComplete Sections 3–5 first. The Diamond, Gemstone and Fancy feeds must be active before the Ring Builder will work correctly.
A β€” Using Your Own Ring Designs
1
Open the Ring Studio Tab
Shopify admin β†’ Apps β†’ Nivoda Connect β†’ Ring Studio tab
2
Create Ring Builder Metafields
Follow the on-screen instructions to create required metafields: Metal, Diamond Shape, Style
3
Install Search & Discovery App
Install the free Shopify Search & Discovery app. Customize filters β†’ Add filter and add: Diamond Shape (Variant Metafield), Metal (Variant Metafield), Style (Product Metafield)
4
Create a Collection
Products β†’ Collections β†’ Create collection (Manual or Smart) β€” this is what the Ring Builder will display
5
Add Your Rings as Products
Add products, set Type = setting. Add variants: Metal + Diamond Shape. Or bulk-import via CSV (Products β†’ Import)
6
Configure Ring Variants
Product page β†’ Variants β†’ Add options. Set: Metal (Yellow Gold, White Gold, Rose Gold). Set: Diamond Shape per variant. Add image, price & availability per variant β†’ Save. If a ring supports multiple shapes, enter all in Supported Shapes metafield β€” no spaces between commas.
7
Add the Ring Builder to a Template
Online Store β†’ Themes β†’ Customize β†’ Create template β†’ name it ring-builder β†’ Add block β†’ Apps β†’ Ring Studio β†’ Select your Collection β†’ Save
8
Create the Ring Builder Page
Online Store β†’ Pages β†’ Add page. Title: Ring Builder or Design Your Ring. Template: select ring-builder β†’ Save. Copy this page URL β€” you'll need it for the Add Diamond button.
β„ΉNivoda ring settings default to a maximum of 3 carats. To increase this, edit the Min/Max Carat fields in each ring's product metafields. Note: mounting prices increase significantly above 3ct β€” adjust your markup accordingly.
B β€” Using Nivoda Ring Designs

Email tech@nivoda.com to request a regional price list. Nivoda's TAM team will upload the ring catalogue to your store at no charge.

⚠If using Nivoda Rings, you MUST enable Nivoda Manufacturing in Settings (Section 8). Without it, orders with non-eligible diamonds will be cancelled.
β„ΉNew Nivoda ring designs are not uploaded automatically. Nivoda will notify you when new collections are available β€” new settings are typically released toward the end of the year. Uploads happen after your approval.
Start With a Diamond

Allow customers to choose a diamond first. Browse to the "Choose a Diamond" tab on your Ring Builder page, copy the URL, and paste into menus or CTAs:

Example "Start With Diamond" URL
https://yourstore.com/pages/ring-builder ?stage=Add+Diamond&isSWS=false&activeTab=Lab+Grown -- Add to menus: Content β†’ Navigation β†’ Mega Menu -- Add to CTAs: Online Store β†’ Customize β†’ paste URL
7

The "Add Diamond" Button (Advanced)

β„ΉThis feature is for stores that keep existing product pages as the starting point. A button on your ring product pages sends customers directly to the diamond selection step. Share the code snippets below with your web developer.
β„ΉThe Ring Builder page is fully optional. You can use only the "Add Diamond" button on specific rings within your Engagement & Bridal collection β€” without a separate Ring Builder page. Contact tech@nivoda.com to configure this.
β–Ά Part 5 β€” How to Add an "Add Diamond" Button on Your Website
1
Open Theme Editor
Shopify Admin β†’ Online Store β†’ Themes β†’ Customize
2
Create a Product Template
Top dropdown β†’ Products β†’ Create template β€” name it e.g. add-diamond
3
Add a Custom Liquid Block
Find the buy buttons section β†’ Add block β†’ Custom Liquid (left menu) β†’ paste the relevant code snippet below
4
Update the Ring Builder URL in the code
Replace /pages/ring-builder with your actual Ring Builder page URL
5
Save & Assign the Template
Save and exit. Assign to individual rings: Products β†’ select product β†’ Template section. Or bulk assign: Products β†’ filter type:setting β†’ Bulk edit β†’ Template column
Developer Code Snippets
All Diamonds (Natural + Lab-Grown)
{% assign settingId = product.id %}{% assign settingVariantId = product.selected_or_first_available_variant.id %} <a id="add-diamond-link" href="/pages/ring-builder?stage=Add+Diamond &settingId={{ settingId }}&settingVariantId={{ settingVariantId }}" class="button button--full-width button--primary">Add diamond</a> <script> document.addEventListener("DOMContentLoaded", function() { var link = document.getElementById("add-diamond-link"); if (link) { link.addEventListener("click", function() { var v = new URLSearchParams(window.location.search).get("variant"); if (v) { var u = new URL(link.href); u.searchParams.set("settingVariantId", v); link.href = u.toString(); } }); } }); </script>
Lab-Grown Diamonds Only
{% assign settingId = product.id %}{% assign settingVariantId = product.selected_or_first_available_variant.id %} <a id="add-lab-diamond-link" href="/pages/ringbuilder-labgrown ?stage=Add+Diamond&settingId={{ settingId }} &settingVariantId={{ settingVariantId }}" class="button button--full-width button--primary"> Add a Lab-Grown Diamond</a>
Gemstones Only
{% assign settingId = product.id %}{% assign settingVariantId = product.selected_or_first_available_variant.id %} <a id="add-gemstone-link" href="/pages/ringbuilder-gemstones ?stage=Add+Diamond &settingId={{ settingId }} &settingVariantId={{ settingVariantId }}" class="button button--full-width button--primary"> Add a Natural Gemstone</a>
8

Configure Your Settings

β–Ά Part 6 β€” How to Configure Your Settings on Nivoda Connect
Markups

Markups are set in your Nivoda account β€” not in Shopify. Without a markup, prices show as $0.

1
Go to Feeds Hub β†’ Markups
Log in to Nivoda β†’ Feeds hub β†’ Markups
2
Set Markups
Set % markups for Natural Diamonds, Lab-Grown Diamonds, Gemstones. Markups can be set by carat weight range or price range.
⚠Only the account owner can view or adjust markups.
β„ΉTo adjust ring or semimount markups, contact the Nivoda TAM team at tech@nivoda.com with your new percentage. Diamond feed markups are managed directly in Feeds Hub β†’ Markups.
Returnable Diamonds

By default, only returnable diamonds are shown. Verify or adjust this per feed block.

3
Find the Returns Toggle
Shopify admin β†’ Online Store β†’ Themes β†’ Customize β†’ Navigate to your Diamond Feed page β†’ click the Nivoda Feed block β†’ Right panel β†’ enable the "Returns" toggle. Repeat for every feed block (each must be set individually).
Order & Fulfilment
πŸ’ŽPRO PLAN ONLY
4
Enable Request Fulfillment
Nivoda Connect Settings β†’ "Request fulfillment" β†’ On. This registers Nivoda as a fulfillment service and creates a new shipping location in Shopify. Important: Set up shipping rates for this new location or checkout will break.
5
Enable Automatic Orders
"Automatically place orders on Nivoda" β†’ On. Paid orders are sent to Nivoda automatically β€” no manual steps.
β„ΉIf products are not adding to cart, the Nivoda fulfillment location likely isn't properly configured in your Shopify shipping and delivery settings. Grant collaborator access to tech@nivoda.com and the team will review and fix it.
Nivoda Manufacturing
πŸ’ŽPRO PLAN ONLY β€” Required if you use Nivoda Rings in the Ring Builder.
⚠If off, any ring order with a non-eligible diamond will be cancelled automatically.
Lead Capture

Collect customer enquiries automatically from any Nivoda page β€” without a third-party form tool.

1
Enable Lead Capture
Apps β†’ Nivoda Connect β†’ Settings β†’ Lead Capture β†’ Toggle "Enable lead capture" On
2
Choose Where It Appears
Select one or more pages: Loose Stone Feed, Ring Studio Setting, Ring Studio Diamond, Ring Studio Review. Customers will see a "Talk to an expert" (or custom) CTA button.
3
Set Your CTA Label
Customise the button text per page (e.g. Save for later, Talk to an expert)
β„ΉLeads are captured via Nivoda's privacy-compliant system. Customers consent to data sharing before their enquiry is sent.
9

Set Up Discounts

πŸ’ŽPRO PLAN ONLY β€” Discount Configuration requires the Pro Plan.

Apply % discounts per product category at the feed block level β€” without changing your markups. Set different rates for Natural Diamonds, Lab-Grown Diamonds, Gemstones and the Ring Builder.

1
Create a Shopify Collection
Products β†’ Collections β†’ Create collection (Manual) β†’ name clearly e.g. Natural Discounted Diamonds β†’ Save
2
Create an Automatic Discount
Discounts β†’ Create discount β†’ Amount off product. Type: Automatic. Title: e.g. Natural Diamond Discount. Value: Percentage (%). Applied to: Specific collection β†’ your new collection. Set eligibility and Save.
3
Assign in Nivoda Connect
Apps β†’ Nivoda Connect β†’ Settings β†’ Discount Configuration β†’ "Add discount for natural diamonds" β†’ assign your collection. No need to press Save β€” configures automatically.
4
Repeat for Other Categories
Repeat steps 1–3 for Lab-Grown Diamonds, Gemstones, Ring Builder
β„ΉFancy coloured diamonds inherit the Natural diamond discount. Ring Builder diamonds use the Ring Builder discount β€” not the Diamond discount.
10

Shopify Setup for High-Value Jewellery

⚠Nivoda does not control Shopify's compliance policies or payment provider risk frameworks. Review your setup carefully before selling loose diamonds or high-value jewellery.
1. Disable Managed Markets

Shopify Managed Markets uses carriers that do not support loose diamonds (value limits ~$5,000, may block checkout in certain countries).

!
Shopify Admin β†’ Settings β†’ Markets β†’ select the Managed Markets market β†’ Deactivate
2. Shipping

Standard Shopify labels are not suitable for loose diamonds or jewellery above ~$5,000. Use a specialist courier:

BrinksMalca-AmitFerrari GroupYour existing secure logistics provider
β„ΉConfirm with your courier: insurance limits, customs handling, and commodity acceptance before shipping.
3. Payments

Shopify Payments may place holds or delay payouts for high-value diamond transactions. Consider: Authorize.Net, PayPal, or Stripe (where permitted).

β„ΉTo add Authorize.Net: Shopify Admin β†’ Settings β†’ Payments β†’ Add payment method β†’ search "Authorize.Net" β†’ enter your API Login ID & Transaction Key β†’ Activate β†’ test before going live.
Pre-Launch Checklist
Managed Markets disabled
Specialist jewellery courier arranged
Insurance coverage confirmed
Payment provider tested for high-value
Test transactions completed
Refund & chargeback policies documented
Diamond & gemstone feeds live
Markups set in Nivoda account
Returns toggle enabled on all feed blocks
Shipping rates set for Nivoda fulfilment location
11

Need Help?

Our team is available 24/7. Whether you're stuck on a step, want a live walkthrough, or need to upgrade your plan β€” just get in touch.

πŸ› 
Technical Support
tech@nivoda.com

Installation, bugs, configuration

πŸ’¬
Sales & Plans
sales@nivoda.com

Upgrading to Pro, plan questions

▢️
Video Tutorials
6 videos in this guide

Click video links in each section

β„ΉTo manage your Nivoda Connect subscription (cancel, downgrade or upgrade), go to Shopify Admin β†’ Settings β†’ Billing β†’ Apps. Nivoda cannot make subscription changes on your behalf.
β„ΉNivoda Connect currently supports one language per store. For multilingual support or to translate the app interface, contact your TAM at tech@nivoda.com.
1:1 Onboarding (Pro Plan)

Pro plan customers receive a personalised onboarding session. Contact your Technical Account Manager or email tech@nivoda.com to book.

Nivoda Connect Installation Guide Β· Version 3.0 Β· April 2026 Β· tech@nivoda.com

Related articles