Skip to content

Storefront Descriptions

Every inventory item in Loupe Factory carries a Storefront Description: the shopper-facing copy you publish on a webshop, marketplace, catalog, or sales sheet. You can type it yourself, or use Write with AI to draft it from the details already on the item record.

The description stays inside Loupe Factory until you send it somewhere. A Shopify product push carries it to the matching Shopify product. Everywhere else, your team copies the finished text into whichever channel needs it, so you decide what goes public and where.

Light mode Storefront Description window for a Fire Opal Pear inventory item, showing the item card, the Write with AI panel, the open tone list with Balanced, Luxury, Technical, Warm, and Concise, the description editor with its character counter, and the Save Description button. Dark mode Storefront Description window for a Fire Opal Pear inventory item, showing the item card, the Write with AI panel, the open tone list with Balanced, Luxury, Technical, Warm, and Concise, the description editor with its character counter, and the Save Description button.

Who Can Write Descriptions

Storefront descriptions are available on every Loupe Factory plan. Users with the Admin or Manager role can write, generate, and edit them. Members do not see the option.

Every save is recorded on the item's history with who made the change and when. For how this sits alongside the other role rules, see Security and Access.

Write a Description with AI

  1. Go to Inventory and open the details page for the item you want to write about.
  2. Click More Actions, then select Storefront Description.
  3. Check the item card at the top of the window. It shows the tag ID, storefront label, shape, size, and inventory type, which is what the AI writes from.
  4. Choose a Tone.
  5. Click Generate. The draft appears in the editor a few seconds later.
  6. Read the draft. Correct anything that does not match the item, rewrite lines that do not sound like your brand, and add headings, lists, or links.
  7. Click Save Description.

If the item already has a description, generating again improves the text you have instead of starting over. To try a different voice on the same item, change the tone and generate again.

Nothing is saved until you click Save Description

Cancel closes the window and discards the draft. The item keeps whatever description it had before.

Choose a Tone

Tone changes the voice, not the facts. All five options write from the same record.

Balanced

Warm, clear, and confident without sounding like an advertisement.

Use it when one house voice has to cover a mixed catalog.

Luxury

Refined, evocative, and sensory. Emphasize craftsmanship, rarity, and the feeling of owning the piece. Never gushing.

Use it when the buyer is paying for rarity, hand work, or provenance.

Technical

Precise and specification-led for detail-oriented buyers. Lead with what it is and exactly what it offers; keep adjectives lean.

Use it when buyers compare specifications before they compare stories.

Warm

Friendly, human, and story-flavored, as if a trusted maker were describing the item across the counter.

Use it when you sell direct and the maker behind the item is part of what people buy.

Concise

Tight, punchy sentences. Every word earns its place; aim for the short end of the length range.

Use it when the listing template gives you two lines, or the channel cuts long copy short.

Balanced is the safe starting point for a mixed catalog. If you are not sure, generate once in Balanced, try one more tone on the same item, and keep the version that sounds like you.

What the AI Reads, and What It Never Sees

The AI sees the shopper-safe part of the item record:

  • product name and storefront product label
  • inventory type and its description
  • finished type or materials and supplies type, and its description
  • shape, size, color, and quality
  • weight and its unit
  • the item's custom attributes
  • your organization's industry

Loupe Factory strips the commercial and internal fields out before the item reaches the AI:

  • unit prices, currency, and rate details
  • cost components and internal pricing
  • internal notes
  • tag IDs
  • HS and HSN codes

Loupe Factory also instructs the AI to write only from what the record says, and never to mention price, availability, discounts, or shipping.

Two things follow from that. A thin record produces thin copy, so fill in shape, size, color, quality, and attributes before you generate. And because price and stock never enter the text, a saved description does not go out of date when you reprice the item or sell the last one.

How the Draft Is Built

Every draft follows the same three-part shape:

  1. an opening paragraph that says plainly what the item is and who it is for
  2. a paragraph on why it is worth choosing
  3. a details list built from the record

That shape is deliberate. Search engines and AI assistants usually answer a shopper by quoting one passage rather than a whole page, so the opening paragraph is written to make sense on its own. The details list then sets out the specifications one line at a time, taken from your record rather than guessed.

Edit Before You Save

The draft lands in a formatting editor, not a plain text box. You can rewrite any line, apply headings, build bulleted or numbered lists, and add links. Descriptions hold up to 8,000 characters, and the counter above the editor tracks how much of that you have used.

Read every draft before saving. The AI writes only from the record, so an inaccurate record produces confident, inaccurate copy. Check that:

  • every specification in the text matches the item
  • the copy claims no certification, origin, or treatment the item does not have
  • the description reads well on its own, without the photo beside it
  • the voice matches your other listings

Where the Description Goes

Where What to expect
The item record The saved description lives on the inventory item, and the item history records who changed it and when.
Inventory CSV exports Included as the Storefront Description column, exported as plain text. See Exporting Inventory to CSV.
The Materials & Supplies export Not included. That export downloads the visible table columns as shown on screen.
The inventory table Not shown on screen. The column appears in the export only.
Shopify Pushed. A Products & Inventory push sends the description to the matching Shopify product. See How Descriptions Reach Shopify.
Other stores and marketplaces Not pushed. Copy the text into the channel yourself.

How Descriptions Reach Shopify

If your workspace uses the Shopify integration, a Products & Inventory push carries the description to Shopify. It is the only channel that receives the copy without someone pasting it in. An admin always starts the push, and the copy travels in one direction.

Direction What happens
Loupe Factory to Shopify A push sends the description as the Shopify product description. Shopify holds one description per product, so when a product has several Finished lots, the newest lot that has copy supplies it.
Shopify to Loupe Factory Nothing. A description rewritten in the Shopify admin is never read back onto the inventory item.

Two things to plan around:

  • A push overwrites hand-edited Shopify copy. Make the edit here, in Loupe Factory, when you want it to survive the next push.
  • Clearing the description here does not clear it in Shopify. An empty description is skipped rather than sent, so the last copy Loupe Factory pushed stays on the Shopify product until you delete it in Shopify. That is also why copy written only in Shopify is left alone.

AI Credit Usage

Generating a description draws on the same AI credit balance as the rest of Loupe Factory's AI features. Credits are calculated from AI token usage at:

1 AI credit per 1,000 tokens, rounded up

A single draft usually costs a small number of credits. Writing or editing the description by hand costs nothing, and neither does saving it.

For allowances, top-ups, and usage history, see AI Credits & Billing.

Tips for Better Descriptions

  • Set the item's storefront product label before you generate. It is the name the AI leads with.
  • Fill in shape, size, color, quality, and weight first. Every empty field is a sentence the AI cannot write.
  • Pick colors from your workspace color list instead of typing them, so the same finish reads the same way across every listing.
  • Start with your best-documented item. It shows you what each tone sounds like at full strength.
  • Keep one description you are happy with as the house reference, and match the rest of the catalog to it.

Next Steps