All articles

Inventory

Generating Descriptions

Fill an item's description automatically — with AI from the item's data, or from a saved template.

Generating Descriptions

Next to the description field on any inventory detail page is a Generate ▾ menu. Open it and pick how you want the description filled:

  • AI — JewelTrak writes a description from the item’s own data (attributes, set stones, certificates, primary photo).
  • Template — fills the field from a saved description template. Only appears if the Description Templates feature is turned on and the item has been saved (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

  1. Open an item detail page (jewelry, watch, diamond, colored stone, or pearl).
  2. Click Generate ▾ and choose AI.
  3. 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

The version live today produces a wholesale tone — concise, fact-forward, suitable for trade or B2B contexts.

Two other tones (retail and short) are reserved in the system and will surface later — likely in a future client-website properties form where you’d want a more consumer-friendly voice. They’re not exposed in the inventory edit forms today.

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 custom story, brand voice, or sales-driven copy — the AI writes accurate descriptions, not marketing prose.

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.