The Plugin Settings page is your main control panel for the Jewelry Builder. It is organized into tabs – General, Filter, Placeholder Images, Shapes, Shortcode, and Import Demo. All settings on a tab save together when you click “Save Changes.”
Location: Go to Jewelry Builder → Settings (or click the main “Jewelry Builder” menu item) in your WordPress admin.
Tab 1 – General Settings
The General tab has two sections: API Setting and Template Setting.
API Setting
These credentials connect the plugin to the Rapaport price list service – an industry-standard diamond pricing feed. You only need these if you want to sync Rapaport price data automatically. If you price your diamonds manually, you can leave these fields empty.
| Field Name | What It Does | Example |
|---|---|---|
Key (username) |
Your Rapaport API username / access key. This identifies your account when fetching price data from the Rapaport feed. |
your-rap-username |
Secret (password) |
Your Rapaport API password / secret token. Keep this private – treat it like a password. |
mySecretKey123 |
Template Setting
| Field Name | What It Does | Options / Notes |
|---|---|---|
Steps Layout |
Controls the visual style of the “Step 1 / Step 2 / Step 3” header bar that customers see at the top of the ring builder. There are 5 layout styles to choose from – each has a different visual design. |
Layout 1 (Default), Layout 2, Layout 3, Layout 4, Layout 5. A preview image appears when you select each option. |
Primary Color |
Your main brand color. Used for buttons, clickable links, and highlighted UI elements throughout the builder. Click the color swatch to open a color picker. |
Hex color code, e.g. |
Secondary Color |
A complementary color used for backgrounds, borders, and supporting UI elements. Should contrast well with the Primary Color. |
Hex color code, e.g. |
Page No Index |
When turned ON, the ring builder, diamond builder, and gemstone builder pages are hidden from search engines (Google, Bing, etc.). Useful if you don’t want these pages appearing in search results. |
Toggle ON / OFF |
Commission Type |
How your markup is added to the stone’s purchase cost to calculate the selling price shown to customers. |
Percentage Discount: adds a % above purchase cost. Fixed Discount: adds a flat dollar/currency amount. |
Commission (In %) |
The actual commission value. If Commission Type is Percentage, enter a number like |
Number between 0 and 100. Default is 0 (no markup). |
Add to Cart Button |
Shows or hides the “Add to Cart” button on the final review step of the ring builder. Turn OFF if you want customers to contact you for pricing rather than purchasing directly online. |
Toggle ON / OFF |
Quick View |
Enables a quick-view popup on the diamond and gemstone list cards so customers can see full details without leaving the browsing page. |
Toggle ON / OFF |
Posts Per Page |
How many diamond or gemstone results are shown per page on the builder listing. A lower number loads faster; a higher number gives customers more options per view. |
Number from 1 to 48. Default is 24. |
Load More data with |
Controls how the next batch of results is loaded when the customer reaches the end of the current page. |
Pagination: shows page numbers. Scroll to load: auto-loads as user scrolls. Load More: shows a “Load More” button. |
Shop Page Loader |
Upload a custom animated image (GIF or SVG) that appears while the diamond / gemstone list is loading. Replaces the default spinner. |
Click to upload via WordPress Media Library. |
Ring Size Chart PDF |
Upload a PDF file of your ring size guide. A link to this PDF will appear in the ring builder so customers can check their ring size before ordering. |
PDF file. Upload via WordPress Media Library. |
Reorder Fields |
A drag-and-drop interface where you choose which data columns are shown on the diamond/gemstone listing cards, and in what order. Drag items between the “Active” and “Inactive” lists. |
Active list = shown on cards. Inactive list = hidden. |
Tab 2 – Filter
The Filter tab has one setting that controls how diamond and gemstone color grades are displayed inside the filter panel on the builder page.
| Field Name | What It Does | Example |
|---|---|---|
Color filter display |
When a customer opens the Color filter (e.g. D, E, F, G…), this setting controls what they see for each grade option. |
Label only: shows the letter grade (D, E, F…). Label + image: shows the grade letter AND a small color swatch image. Image only: shows only the color swatch. Default is Label + image. |
Tab 3 – Placeholder Images
This tab lets you upload a custom image for each diamond or gemstone shape. These images appear on the builder listing and detail cards when a product does not have its own photo. There is one upload slot per shape. See Placeholder Images for the full list of shape slots.
Tab 4 – Shapes
The Shapes tab lets you upload the individual shape icon images used inside the ring builder shape-selector filter. Customers click these icons to filter diamonds or gemstones by shape. Upload SVG or PNG icons for each shape – Round, Pear, Princess, Oval, etc.
Tab 5 – Shortcode
The Shortcode tab shows you the shortcodes you can paste into any WordPress page to embed the builder. You do not need to type these – they are shown here for your reference so you can copy and paste them.
| Shortcode | What It Displays |
|---|---|
[jewelry_ring_builder] |
Embeds the full 3-step Ring Builder on any WordPress page or post. |
[jewelry_diamond_builder] |
Embeds the standalone Diamond browsing page (no ring selection required). |
[jewelry_gemstone_builder] |
Embeds the standalone Gemstone browsing page. |
The plugin also works with virtual URLs (/ring-builder/) that do not require a WordPress page. Using shortcodes is optional – handy if you want to embed the builder inside a page that already has other content like a header banner or text.
Tab 6 – Import Demo
If you skipped the demo import during the Setup Wizard, or if you want to reload fresh demo data, use this tab to import 300 sample diamonds and 300 sample gemstones in one click. This is useful for testing the builder before you load your real inventory.
The demo import adds to your existing records – it does not replace them. If you have already imported real inventory, run this in a test environment or delete your existing records first.