Natural gemstones are colored stones mined from the earth – rubies, sapphires, emeralds, and dozens of other precious and semi-precious stones. The plugin stores them in a dedicated catalog so customers can choose gemstones as the center stone for their custom ring.
Location: Go to Jewelry Builder → Natural Gemstones in your WordPress admin.
Why a Separate Gemstone Catalog?
Gemstones differ from diamonds in significant ways – they come in many colors and stone types (Ruby, Sapphire, Emerald, Amethyst, etc.), they may have “fancy colors” with multiple color properties, and their grading is different from the standard diamond 4Cs. Keeping them in a separate catalog makes it easy for customers to switch between “I want a diamond” and “I want a colored gemstone” in the builder.
Gemstone Fields – Full Reference
Gemstone records have more fields than diamond records because colored stones require additional color descriptors. Fields marked Required must be filled in for the record to be accepted during import.
| Field Name | Required | Description | Example |
|---|---|---|---|
Gemstone ID |
Yes |
A unique identifier for this gemstone. No two gemstones can share the same ID. |
GEM-5001 |
Shape |
No |
The cut shape of the gemstone – same options as diamonds plus additional shapes specific to gemstones. |
Round, Oval, Cushion, Pear, Emerald Cut, Cabochon |
Size (Carat) |
No |
The weight of the gemstone in carats. Gemstones of different types weigh differently per unit volume. |
2.35 |
Color |
No |
The primary color of the gemstone. For colorless/white gemstones, this uses the D–Z diamond scale. For colored gemstones, this describes the hue. |
Blue (Sapphire), Red (Ruby), Green (Emerald) |
Fancy Color – Dominant Color |
No |
The main color of a fancy-colored gemstone when it has complex coloring. Used for stones with multiple color characteristics. |
Deep Blue, Vivid Pink, Intense Yellow |
Fancy Color – Secondary Color |
No |
A secondary color present in the gemstone alongside the dominant color. |
Violet (in a Blue-Violet Tanzanite) |
Fancy Color – Overtone |
No |
A subtle surface color that modifies the main color – the hue you see in certain lighting angles. |
Pinkish, Orangy, Greenish |
Fancy Color – Intensity |
No |
How strong and saturated the color is. Higher intensity means a richer, deeper color. |
Faint, Light, Fancy, Fancy Intense, Fancy Vivid, Fancy Deep |
Clarity |
No |
How free the gemstone is from inclusions (internal flaws). Different gemstone types have different acceptable clarity standards – many colored gems naturally have more inclusions than diamonds. |
Eye Clean, Slightly Included, Included, Heavily Included |
Cut |
No |
The quality of the cut and faceting. Well-cut colored stones show better color and brightness. |
Excellent, Very Good, Good, Fair |
Polish |
No |
The quality of the stone’s surface finish. A better polish means a smoother, more mirror-like surface. |
Excellent, Very Good, Good, Fair, Poor |
Symmetry |
No |
How evenly balanced the facets are on both sides of the stone. |
Excellent, Very Good, Good, Fair, Poor |
Depth Percent |
No |
The depth of the stone as a percentage of its width. Affects how light travels through the stone. |
|
Table Percent |
No |
The size of the flat top facet (the table) as a percentage of the stone’s width. |
58.0 |
Meas Length |
No |
The physical length of the stone in millimeters. |
8.50 |
Meas Width |
No |
The physical width of the stone in millimeters. |
6.20 |
Meas Depth |
No |
https://online-video-cutter.com/ |
4.15 |
Girdle Min / Max |
No |
The minimum and maximum thickness of the girdle (the narrow band around the widest part of the stone). Affects durability. |
Thin, Medium, Slightly Thick |
Culet Size / Condition |
No |
The size and condition of the tiny facet at the very bottom tip of the stone. None or Very Small is ideal. |
None, Very Small, Small, Medium |
Fluorescence Color / Intensity |
No |
Whether the stone glows under UV light, and how strongly. Some customers care about this; others don’t. |
Blue / None, Faint, Medium, Strong, Very Strong |
Lab |
No |
The grading lab that issued the certificate for this gemstone. |
GIA, AGL, GRS, Gübelin, SSEF |
Certificate Number |
No |
The unique certificate number from the grading lab. |
5678901234 |
Stock Number |
No |
Your internal stock or inventory number for this stone. |
INV-2024-0876 |
Video URL |
No |
A link to a 360° video or close-up video of this specific gemstone. Hosted externally (YouTube, Vimeo, or supplier video URL). |
https://video.example.com/gem5001 |
Image File |
No |
A direct URL to the main product image for this gemstone. If empty, the shape placeholder image is used. |
https://cdn.example.com/images/gem5001.jpg |
Eye Clean |
No |
Whether the stone appears clean (free of visible inclusions) to the naked eye. Yes/No or 1/0. |
|
Is BGM |
No |
“BGM” stands for Brown, Green, or Milky – undesirable tints sometimes found in diamonds and some gemstones. Set to 1 (Yes) if the stone has a BGM tint. |
|
Total Purchase Price |
Yes |
Your cost price for this gemstone. Used to calculate the customer-facing price via commission. |
780.00 |
Total Sales Price |
No |
The price shown to customers. Leave blank to auto-calculate using commission, or enter manually. |
1100.00 |
City / Country |
No |
Where the gemstone is located or from which region it originates. Useful for provenance information. |
Bangkok, Thailand |
Seller Account ID / Company / Name |
No |
Supplier contact information – your reference for who you bought this stone from. Not shown to customers. |
Your internal supplier codes |
Key Field Explanations
Fancy Color Fields
Colored gemstones often have complex color characteristics described by multiple terms. A fine sapphire might be described as “Vivid Blue with a slight Violet overtone.” The four fancy color fields (Dominant Color, Secondary Color, Overtone, Intensity) let you store this detailed color information. Customers can filter by color intensity or dominant color to find exactly the shade they want.
Measurements (Length, Width, Depth)
Physical measurements in millimeters are very helpful for customers choosing a gemstone for a specific ring setting. A ring designed for a 7×5mm oval center stone needs a gemstone that fits those dimensions. Always enter measurements if you have them.
Eye Clean
“Eye clean” means the stone looks flawless to the naked eye – inclusions are only visible under magnification. For colored gemstones, eye-clean is often more important than the official clarity grade because many customers won’t look at their gemstone under a loupe. Marking a stone as eye-clean helps customers feel confident about purchasing without seeing it in person.
Video URL
Online gemstone shoppers rely heavily on videos because photos don’t fully capture how a stone looks in light. If your supplier provides 360° video links for their stones, paste those URLs into this field. The builder will display an embedded video player so customers can examine the stone from all angles before buying.
Tips for Gemstone Management
- Fill in as many fields as possible – richer data means better filtering for customers and more confidence to buy online.
- Always include a Video URL when available – colored gemstones sell much better with video than with photos alone.
- Use consistent color names (e.g., always “Blue” not sometimes “Blue” and sometimes “blue” or “BLUE”) so the color filter works correctly.
- Gemstone Gemstone IDs must be unique across both natural and lab gemstone catalogs – don’t reuse an ID you used in the natural gemstone catalog for a lab gemstone.