Product page · Article 7 of 10

Product descriptions and specs: how to write and structure them

Write every description to the same level of detail. Put the key benefit in or right under the product name, show a short summary near the top, and use bullets for facts and short paragraphs for context. Use plain words, start the description close to the buy box on phones, and make specs consistent, explained and complete with units.

In this article · 10 tips
  1. What a product description has to do
  2. 1Write every description to the same level of detail
  3. 2Put the key benefit in the product name or right under it
  4. 3Show a short summary near the top of the page
  5. 4Use bullets for facts and short paragraphs for context
  6. 5Give long descriptions headings shoppers can scan
  7. 6Use plain words, not marketing language
  8. 7On phones, start the description close to the buy box
  9. 8Repeat the key facts in both the description and the specs
  10. 9Make specs scannable, consistent across products, and give every number a unit
  11. 10Explain spec labels shoppers might not know
  12. FAQ

In short

  • Shoppers scan descriptions for the answer to one question. Headings and bullets let them find it.
  • Marketing language makes products sound alike. Specific facts make them different.
  • Specs only help if shoppers understand them and can compare them across products.
  • One thin description among detailed ones makes that product look like the weak option.

What a product description has to do

The description is where shoppers go when the photos haven't answered their question. They arrive looking for something specific: the material, whether it's dishwasher safe, what it's for, how it compares to the other model. A description that's one block of brand language, or three vague lines, sends them away to search elsewhere.

Good descriptions do two jobs: explain why this product is worth buying, and answer the practical questions. The specs do a third: let shoppers compare.

1Write every description to the same level of detail

Every product of a type should get the same depth. One thin description makes that product look worse.

All stores

✕ Avoid

9:41

Stoneware mug

9:41

Glass mug

Great mug.

One mug gets a full description, the other two words. The second looks like the weaker product.

✓ Do this

9:41

Stoneware mug

Capacity · Material · Care

9:41

Glass mug

Capacity · Material · Care

A template per product type: every mug covers capacity, material, care and size.

Why it matters

When some products have rich descriptions and others have two lines, the thin ones look less trustworthy, and shoppers comparing products can't compare what isn't there. Inconsistency also hurts search: thin pages rank worse.

How to do it

  • Make a description template per product type: what to cover (purpose, key features, materials, size, care, compatibility) and in what order.
  • Fill every product to that template, starting with best sellers and products with high traffic and low conversion.
  • Rewrite supplier descriptions in your own words; copied text helps no one and ranks poorly.

On ShopifyCode

Store template sections in metafields (materials, care, fit) so every product has the same structure and the theme shows them in the same place.

Quick test: Do all products of the same type have descriptions with the same level of detail?

2Put the key benefit in the product name or right under it

Put what the product is and what makes it different in the name or right under it.

All stores

✕ Avoid

9:41

The Ridge

$189

"The Ridge" says nothing to a new visitor. Is it a boot, a backpack, a tent?

✓ Do this

9:41

Ridge waterproof hiking boot

Light enough for day hikes, warm to −20°C

$189

The name says what it is; the subtitle says why it's different.

Why it matters

The product name is read by everyone; the description by far fewer. When the name is just a model code or a brand line ("The Classic"), shoppers learn nothing. A name or subtitle that says what makes it different does the first piece of selling.

How to do it

  • Make the name descriptive: what it is plus the key differentiator ("Waterproof hiking boot", not just "Ridge").
  • Add a one-line subtitle under the name with the main benefit or use ("Light enough for day hikes, warm to −20°C").
  • Keep the brand's product name if it's known, but pair it with what it is.

On ShopifyTheme setting

Add a subtitle as a metafield shown under the title, or a text block that reads from a metafield.

Quick test: Does the product name or subtitle say what the product is and what makes it different?

3Show a short summary near the top of the page

Give the essentials near the buy box. Many shoppers decide from the first screen.

All stores

✕ Avoid

9:41

Spore probiotic

$49

Add to cart

↓ Description is 6 scrolls down

The reasons to buy are far below. Shoppers who decide early never see them.

✓ Do this

9:41

Spore probiotic

$49

✓Survives stomach acid

✓One capsule a day

✓Third-party tested

Add to cart
Three short highlights by the price. The full description follows below.

Why it matters

Many shoppers decide from the first screen. If the description starts far below the photos and options, they never see why the product is worth its price. A short summary near the buy box gives the essentials early.

How to do it

  • Add two to four short bullet points or a couple of sentences near the buy box: what it is, who it's for, the key reasons to buy.
  • Link to the full description for details ("Full details").
  • Don't repeat the full description there; summarize it.

On ShopifyTheme setting

Add a text block or a "Highlights" metafield in the product information section, above or below the price.

Quick test: Is there a short summary of the product's key points near the buy box?

Spore Probiotic: the page before the redesign
Before
Spore Probiotic: the page after the redesign
After

From my work · +8.6% subscription conversion rate

A spore probiotic had survey results most brands would lead with, buried far down the page. The redesign made them the headline near the top, added a picker that showed the result for each shopper's problem, and cleaned the buy box.

See the spore probiotic case study

4Use bullets for facts and short paragraphs for context

Paragraphs for context, bullets for facts. A wall of either is hard to read.

All stores

✕ Avoid

9:41

About this blender

One long block of text. Shoppers looking for one fact give up.

✓ Do this

9:41

About this blender

Smoothies, soups and nut butters in under a minute.

•1,400 W motor

•2 L jar, dishwasher safe

•7-year warranty

A short paragraph on what it's for, then the facts as bullets.

Why it matters

A wall of text is hard to scan; a list of 20 bullets loses the story. Bullets suit facts shoppers scan for (materials, dimensions, features). Short paragraphs suit what a list can't carry: how it feels to use, why it was made that way, who it's for.

How to do it

  • Lead with one or two short paragraphs about what the product is and why it's good.
  • Follow with bullets for features and facts, one idea per bullet, starting with the most important.
  • Keep paragraphs to two or three sentences.

On ShopifyBuilt in

The Shopify product description editor supports paragraphs, bullets and headings.

Quick test: Does the description combine short paragraphs for context and bullets for facts?

5Give long descriptions headings shoppers can scan

Long descriptions are fine if headings let shoppers jump to what they care about.

All stores

✕ Avoid

9:41

Mattress

A long description without breaks. Finding the part about firmness means reading everything.

✓ Do this

9:41

Mattress

How it feels

What's inside

Care and trial

Short sections with headings. Shoppers scan the headings and read the part they need.

Why it matters

Long descriptions are fine, even useful, for complex or expensive products, but only if shoppers can jump to the part they care about. Headings turn a long text into a set of answers.

How to do it

  • Split long descriptions into sections with clear headings: "How it works", "Materials", "Who it's for", "Care".
  • Consider a "Highlights" structure: three to five key features, each with a short heading, a sentence and an image.
  • Keep the most important section first.

On ShopifyTheme setting

Use headings inside the description, or split the content into collapsible rows and image-with-text sections fed by metafields.

Quick test: Are long descriptions split into sections with clear headings?

6Use plain words, not marketing language

Facts beat adjectives. "Premium" means nothing; "full-grain leather, 1.4 mm" does.

All stores

✕ Avoid

9:41

Leather laptop sleeve

Elevate your everyday with our premium, luxurious, timeless sleeve, crafted for the modern professional.

Marketing words every store uses. Shoppers skip them looking for facts.

✓ Do this

9:41

Leather laptop sleeve

Full-grain leather, 1.4 mm thick. Fits 13" and 14" laptops. Wool felt lining. Darkens with use.

Specific facts in plain words. Each line answers a question.

Why it matters

"Premium", "revolutionary", "elevate your everyday" appear on so many products that they mean nothing. Shoppers skip them looking for facts. Plain, specific language builds trust and helps people decide.

How to do it

  • Replace adjectives with facts: not "premium leather" but "full-grain leather, 1.4 mm thick".
  • Explain jargon the first time you use it, or avoid it.
  • Write the way your customers talk about the product in reviews.
  • Keep brand voice for the opening line, then get specific.

On ShopifyBuilt in

Nothing to set up. Check your descriptions against your reviews: if customers praise something you don't mention, add it.

Quick test: Is the description written in plain, specific words instead of marketing language?

7On phones, start the description close to the buy box

On phones, the description should start soon after the buy box, not below a pile of apps.

Phones

✕ Avoid

9:41
Add to cart

Trust badges

Reviews carousel

Instagram feed

Newsletter

Description ↓

Apps and banners stack between the button and the description. Most phone shoppers never reach it.

✓ Do this

9:41
Add to cart

Free delivery by Thu · Free returns

Description−

Fit and sizing+

The description comes right after delivery and returns, where shoppers expect it.

Why it matters

On a phone, everything below the buy box is a long scroll away. If apps, banners and recommendation rows sit between the buy box and the description, many shoppers never reach it.

How to do it

  • Place the description (or its first section) directly after the buy box and delivery information on phones.
  • Move badges, trust-icon rows and recommendation rows below it.
  • Check on a small phone how far a shopper has to scroll to reach it.

On ShopifyTheme setting

Reorder blocks and sections in the theme editor's mobile preview, and remove app blocks that push content down.

Quick test: On a phone, does the description start soon after the buy box?

8Repeat the key facts in both the description and the specs

The facts that decide the purchase belong in both the description and the specs, with the same numbers.

All stores

✕ Avoid

9:41

Light at about 2.5 kg…

Weight2.1 kg

Capacity30 L

2.5 or 2.1 kg?

The description says 2.5 kg, the specs say 2.1 kg. Shoppers stop trusting both.

✓ Do this

9:41

At 2.1 kg, it's one of the lightest 30 L packs…

Weight2.1 kg

Capacity30 L

The key facts appear in both places, with identical numbers.

Why it matters

Some shoppers read the description, others go straight to the specs. If the battery life is only in the description or the material only in the specs, half your shoppers miss it.

How to do it

  • Make sure the facts that decide the purchase (size, weight, material, capacity, compatibility) appear in both places.
  • Keep the numbers identical in both. Mismatches destroy trust.

On ShopifyCode

Store key facts once in metafields and show them in both the description area and the specs table, so they can't drift apart.

Quick test: Do the deciding facts appear in both the description and the specs, with the same numbers?

9Make specs scannable, consistent across products, and give every number a unit

Specs are for comparing. That needs the same labels, order and units on every product.

Spec-heavy products

✕ Avoid

9:41

Specifications

Weight2.1

SizeLarge

Battery5000

Wattage–

Missing units, vague values and gaps. Comparing with the next product is impossible.

✓ Do this

9:41

Specifications

Weight2.1 kg

Dimensions52 × 30 × 20 cm

Battery5,000 mAh

Power65 W

Same labels and order across products, a unit on every number.

Why it matters

Specs are how shoppers compare. If one product lists "Weight: 2.1" and another "Weighs approx. 2 kilos", and a third doesn't list weight at all, comparison is impossible. Supplier data is usually inconsistent, so it needs cleaning.

How to do it

  • Show specs as a two-column table: label on the left, value on the right, with light row separators.
  • Group long spec sheets (Dimensions, Power, Materials) and put the most important specs first.
  • Use the same labels, order and units for every product of a type. Clean up supplier data before it goes live.
  • Add the unit to every number (kg, cm, mAh, W), and show both metric and imperial if you sell internationally.

On ShopifyCode

Use metafields with definitions (dimension, weight, volume types carry their unit) and render them as a table in the theme, so every product follows the same structure.

Quick test: Are specs shown in a consistent table, with the same labels and a unit on every number?

10Explain spec labels shoppers might not know

Explain specs that only experts understand, in words shoppers use.

Spec-heavy products

✕ Avoid

9:41

Specifications

RatingIP67

Fabric300 GSM

Denier600D

IP67? 300 GSM? 600D? Most shoppers don't know what these mean or whether they're good.

✓ Do this

9:41

Specifications

WaterproofingIP67

Dust-tight, survives 30 min under 1 m of water

Fabric weight300 GSM

Midweight: warm but breathable

Each technical spec followed by what it means in use.

Why it matters

Specs like "IP67", "thread count", "GSM" or "denier" mean a lot to experts and nothing to most shoppers. Unexplained, they either get ignored or make shoppers feel they're in the wrong shop.

How to do it

  • Add a short explanation next to technical labels: "IP67 (dust-tight, waterproof to 1 m)".
  • Use a small info icon or tooltip for longer explanations, and make it work on tap.
  • Translate specs into what they mean in use: "5000 mAh (about two days of normal use)".

On ShopifyCode

Add explanations as metafield definitions' descriptions or as text in the spec template.

Quick test: Are technical spec labels explained in plain words?

FAQ

How long should a product description be?

Long enough to answer what shoppers ask before buying, and structured so they can find it. Simple products might need 100 words; complex ones several hundred, split into sections.

Should product descriptions use bullet points?

Yes, for facts and features. Pair them with a short paragraph about what the product is and who it's for.

Can I use the manufacturer's product description?

Use its facts, but write the description in your own words. Copied text is on every other store selling the product and does nothing for search.

Sources

Alex Peric

Written by Alex Peric

Conversion designer. I design, redesign and build online stores, product pages and landing pages, A/B test them and show what each change earned. CXL certified in Conversion Optimization and Ecommerce Marketing, and a guest speaker on ecommerce UX at NYU School of Professional Studies.

Let's talk

Let's find out why your visitors aren't buying.

Send me the page. On the call I'll tell you what I'd fix first, what it could move, and whether I'm the right person for it.

Book a call