Skip to content
All articles
Product pages3 min read

Specification table best practices: 12 rules for clear product specs

From grouping and naming attributes to units, tooltips and mobile layout: twelve practical rules to design specification tables that shoppers actually read.

A specification table can be a shopper’s best friend or an intimidating wall of jargon. The difference lies in dozens of small decisions: what to include, how to name things, how to format values.

Here are twelve rules we’ve learned from helping merchants set up specification tables — from electronics to furniture, sports equipment and fashion.

Content

1. Start from customers’ questions, not from the supplier sheet

Supplier data sheets are written for distributors. Your customers care about fewer things, expressed differently. Go through support emails, reviews and returns: Does it fit? Is it compatible? How long does it last? Each recurring question deserves an attribute.

2. Keep the essentials visible

Put the most decisive attributes first, and don’t show fifty rows at once. A “View more” button keeps long tables compact while leaving the details one click away.

3. Be consistent across similar products

Every product of the same family should display the same attributes, in the same order, with the same names. Consistency makes tables scannable — and it’s a prerequisite for comparison tables.

4. Hide what doesn’t apply

An attribute with no value for a product shouldn’t appear as an empty row or a dash. Hide empty rows so each table only contains relevant information.

Structure

Split long lists into groups with explicit names: “Dimensions”, “Performance”, “Battery”, “In the box”. Aim for roughly five to ten attributes per group. Groups let shoppers skip straight to what matters to them.

6. Use one table template per product family

Don’t create a different table for every product, and don’t force one generic table on your whole catalog. One template per family (“Camera”, “Sofa”, “Running shoe”) is the sweet spot — and a good test is to ask: would a shopper compare these products?

Wording and formatting

7. Name attributes the way customers talk

“Noise level” beats “Acoustic emission”. “Fits laptops up to” beats “Internal compartment dimensions”. Keep names short — ideally one to four words.

8. Explain jargon with tooltips

Some technical terms are unavoidable: IPX4, ANC, ISO, mAh. A short tooltip (“Protected against splashing water”) helps non-experts without cluttering the table for experts.

9. Use real units, and the right system

“40 h” is clearer than “40”. Always display units, and adapt them to the shopper: centimeters and kilograms for metric countries, inches and pounds for the US. Automatic unit conversion based on the shopper’s country removes the mental math.

10. Prefer visuals when they’re clearer than words

Color swatches instead of color names, checkmarks instead of “Yes/No”, a meter bar for comfort or durability ratings, small icons next to key attributes. Visual values are faster to scan — as long as they stay accessible to screen readers.

Design

11. Make it look native to your store

A table that looks like a foreign widget undermines trust. Match your theme’s typography, colors and spacing. Subtle borders or zebra stripes help the eye follow rows; heavy grids don’t.

12. Design for mobile first

Most shoppers browse on their phones. On narrow screens, stacking attribute names above values often reads better than two cramped columns. Test your tables on a real phone, not only in a desktop browser.

Bonus: technical rules that pay off

  • Render tables in the page HTML so search engines can index them (why it matters for SEO).
  • Avoid layout shifts when the table loads.
  • Translate everything — attribute names, group names, tooltips and text values.
  • Store data natively in Shopify (metafields) so it stays fast, portable and reusable (metafields or an app?).

Applying these rules with Specs & Compare

Most of these rules are built into Specs & Compare:

RuleFeature
Keep essentials visibleVisible rows setting with a “View more” button
ConsistencySpecification tables used as templates, assigned by conditions
Hide what doesn’t applyHide empty rows (on by default)
GroupsGroups and drag-and-drop ordering
Tooltips and iconsTooltip and icon on every attribute
UnitsTyped dimension and weight attributes with automatic unit conversion
Visual valuesColor swatches, true/false icons, scale meter bars, metaobject thumbnails
Native lookTheme fonts and a visual table editor
MobileStacking strategy and responsive layouts

The quick start guide gets you from zero to a published table in a few minutes.