Generating Descriptions
Next to the description field on any inventory detail page is an AI button (✨). Click it and JewelTrak writes a description from the item’s own data (attributes, set stones, certificates, primary photo).
If your shop has the legacy Description Templates feature turned on, the button becomes a Generate ▾ dropdown with two choices — AI (the above) and Template (fills from a saved description template; see below).
Either way the text just drops into the field — review it, edit if needed, and Save.
New in JewelTrak. No equivalent existed in the legacy app.
AI
- Open an item detail page (jewelry, watch, diamond, colored stone, or pearl).
- Click Generate ▾ and choose AI.
- The button shows Generating… for a few seconds, then the description fills in.
The generator reads everything JewelTrak already knows about the item — material, weight, dimensions, color, clarity, vendor, set stones, GIA cert numbers, the primary photo — and writes a description from those facts. It doesn’t invent details. AI works on a brand-new item too (before you’ve saved), using whatever you’ve typed in the form so far.
From template
If your shop migrated from the legacy app’s SQL-driven description logic, a platform admin can turn on Description Templates under Settings → Features. Then Generate ▾ → Template fills the description from your configured description view (set up under Admin → Tag Views → Descriptions). The Template choice only shows once the item is saved. See Tag Views Admin.
AI stays the default for everyone; templates are an opt-in for clients who want the legacy deterministic output.
Tone
JewelTrak picks the right tone automatically for where you are:
- Inventory item AI button → a wholesale tone — concise, fact-forward, for trade/B2B.
- House Designs → a retail tone — fuller, customer-friendly copy.
- Website panel → web description + a short web title.
- Appraisals → a clinical, factual appraisal description (it will not invent condition it wasn’t given).
You don’t choose these — the system uses the one that fits the page.
House voice
You can give the customer-facing descriptions (House Designs + website) your shop’s own personality. Under Settings → Organization → AI Description Voice, pick a voice — Professional (default), Elegant & Luxury, Warm & Friendly, Modern & Minimal, or Estate & Heritage — and optionally add a line or two of house notes (e.g. “we specialize in vintage,” “never use the word ‘cheap’”).
That voice then flows into every customer-facing description automatically. The factual ones (the inventory item AI button, appraisals, line items) stay neutral on purpose — you don’t want personality in a trade spec or an insurance appraisal. The AI honors your notes where relevant but never invents facts about a piece to satisfy them.
Rate limit
The AI is a paid third-party service (Anthropic’s Claude). To keep costs predictable and protect against a compromised account running a tight loop, every user has a per-window rate limit on this button. If you hit it, you’ll see a rate-limit error — wait a few minutes and try again.
When to use it (and when not to)
Good fit: Items you’ll list online or send to wholesale customers, where a quick honest description matters and you don’t want to write 100 of them by hand.
Less good fit: Hero items where you want a hand-crafted story or sales-driven copy. (For a consistent brand personality across all your customer-facing copy, set a house voice — see above — rather than rewriting each one.)
You can always run the generator, then edit the result. The output is a starting point, not a final draft.
What if the description is wrong?
The AI works only from data already in JewelTrak. If a description is off, the most common cause is missing or wrong source data — for example, the item doesn’t have a primary photo, the set-stones list is incomplete, or a metal/material field was left blank. Fix the source data and rerun.