Clear product information starts before the product page

A product page can only be as clear as the information behind it. Start with one item and decide which details belong to the product, its variants and its stock records.

Give the product a stable identity

Choose a name that tells customers what the item is. Keep the main description focused on details shared by its versions, such as its purpose, material and care instructions when relevant.

For a ceramic mug sold in two colours, a single product name is easier to maintain than unrelated names for each colour. Keep promotional phrases out of internal identifiers so the team can still recognise the item when a campaign ends.

Separate options from variants

An option describes a choice, such as colour or capacity. A variant is a particular combination of those choices. If some combinations are not sold, do not present them as selectable products.

Give each variant a distinct stock keeping unit (SKU). A SKU helps the team distinguish versions; it is not the customer-facing product name. Use a convention your team understands and applies consistently.

Attach details to the right version

Use images that represent the selected variant. If price, dimensions or another detail differs between versions, keep that difference explicit. Do not make the customer infer it from a photograph or a vague description.

For example, imagine a ceramic mug available in cream and blue, both with a capacity of 300 ml. The capacity belongs to both versions; the colour and SKU distinguish them.

Keep stock separate from the description

The product description explains the item. Stock records describe quantities in a particular warehouse. Editing a name or replacing a photo does not, by itself, update those quantities.

Before presenting stock information to a customer, identify the variant and the warehouse context behind it. Keep marketing copy separate from quantity records so a copied description does not become an outdated stock statement.

Review one item from the customer's side

Before adding a large catalog, review one complete product and its versions:

  • Does the name clearly identify the product?
  • Does each choice lead to the intended variant?
  • Do its photo and details match that variant?
  • Can the team distinguish the variants by SKU?

Resolve differences in this first record, then use the same structure for similar products. The goal is information that customers can understand and your team can keep accurate.