Aurelia Hub Documentation

Product Attributes & Custom Fields

Last updated: 22. February 2026

Aurelia Hub provides extensive jewelry-specific fields and a flexible attributes system to capture every detail of your products.

Built-in Jewelry Fields

Metal Properties

Field Description Example Values
metal Base metal type Gold, Silver, Platinum, Palladium, Titanium, Stainless Steel
metal_color Metal color variant White Gold, Rose Gold, Yellow Gold
metal_purity Purity/fineness 750 (18K), 585 (14K), 375 (9K), 925 (Sterling)

Stone Properties

Field Description Example Values
stones JSON array with stone details Structured stone data
number_of_stones Total count 1, 3, 7, etc.
stone_cut Cut style Brilliant, Emerald, Princess, Cushion, Marquise, Oval, etc.
stone_weight Total carat weight 0.50, 1.00, 2.35
stone_color Color grade Various per stone type
stone_clarity Clarity grade Various per stone type

Available Stone Cuts

Aurelia Hub supports 15 standard gemological cuts:

  • Brilliant Cut, Emerald Cut, Asscher Cut, Princess Cut, Radiant Cut
  • Rose Cut, Briolette Cut, Trilliant Cut, Baguette Cut, Oval Cut
  • Marquise Cut, Cushion Cut, Pendeloque Cut, Cabochon Cut, Mixed Cut

Diamond 4Cs

For diamond products, dedicated fields capture the industry-standard 4Cs:

Color (D–Z scale):

  • D, E, F — Colorless
  • G, H, I, J — Near Colorless
  • K, L, M — Faint Yellow
  • N–Z — Light Yellow

Clarity (FL to I3):

  • FL — Flawless
  • IF — Internally Flawless
  • VVS1, VVS2 — Very Very Slightly Included
  • VS1, VS2 — Very Slightly Included
  • SI1, SI2 — Slightly Included
  • I1, I2, I3 — Included

Cut (quality grades):

  • Excellent, Very Good, Good, Fair, Poor

Carat: Free-form decimal field for carat weight.

Watch-Specific Properties

Field Description
case_type Case material/type (steel, gold, ceramic)
bezel Bezel style (smooth, fluted, diamond-set)
movement Movement type (automatic, quartz, manual wind)
water_resistance Water resistance rating (30m, 100m, 300m)
caliber Movement caliber number
bracelet_type Strap/bracelet type (leather, metal, rubber)
dial Dial description (color, texture)

Sizing Fields

Field Description
ring_size Ring size (varies by region)
necklace_length Chain length in cm/inches
bracelet_length Bracelet length in cm/inches

Custom Attributes (JSON)

The attributes field stores a JSON object for any additional data that doesn't fit the standard fields. This is fully flexible:

{
  "engraving": "Forever Yours",
  "gift_wrapping": true,
  "special_order": false,
  "supplier_ref": "SUP-12345",
  "custom_note": "Customer requested matte finish"
}

Product Attributes can also be managed via the ProductAttribute model, which stores structured key-value pairs linked to specific products.

Stone Types

Aurelia Hub recognizes 33 gemstone types:

  • Precious: Diamond, Ruby, Sapphire, Emerald
  • Semi-Precious: Alexandrite, Spinel, Topaz, Tourmaline, Amethyst, Citrine, Aquamarine, Garnet, Peridot, Tanzanite, and many more
  • Organic: Pearl, Amber, Coral
  • Ornamental: Lapis Lazuli, Turquoise, Malachite, Onyx, Agate, Jasper

Certificate Issuers

Products can reference certificates from recognized gemological laboratories:

  • GIA (Gemological Institute of America)
  • AGS (American Gem Society)
  • SSEF (Swiss Gemmological Institute)
  • Gübelin Gem Lab
  • IGI (International Gemological Institute)
  • HRD (Hoge Raad voor Diamant)
  • GGTL, AGL, Lotus Gemology, GIC, NGTC, CGL
  • Other (custom entry)

Media Collections

Each product supports organized media:

  • Main — Single primary image
  • Gallery — Multiple additional images
  • Technical — Technical/detail photographs
  • Documents — PDFs, spreadsheets, Word documents
  • Certificates — Certificate scans and PDFs

Accepted formats: JPEG, PNG, WebP for images; PDF, DOC, DOCX, XLS, XLSX for documents.

Was this article helpful?