Key Attributes

Every product has one or two things that make it the right choice. Key Attributes surfaces those things — not in a paragraph of description copy, but as structured, filterable, badge-ready signals at the point of decision.

OVERVIEW

The Key Attributes field captures the two to five most purchase-decision-relevant characteristics of a product that are not already covered by other structured metafields. It is a flexible, cross-category field designed to highlight what makes a specific product stand out within its category — features, technologies, design decisions, or performance claims that directly drive conversion.

Key Attributes is not a description field. It is not a place for marketing language. It is a structured list of factual, verifiable product characteristics that answer the question: why should I choose this one over the alternatives? Each value should be a concrete, scannable claim — something a customer can read in under three seconds and immediately understand.

BUSINESS VALUE

Why this field matters

  • Key attributes answer the 'why this one?' question at the moment of decision — they are the structured equivalent of a salesperson's three-sentence pitch

  • Structured key attributes enable comparison-based filtering: 'show me all tents with a vestibule and a footprint' is only possible if these attributes are structured data

  • AI recommendation systems use key attributes to match products to stated customer requirements — 'I need something lightweight and packable'

  • Key attributes power badge strips on product cards in collection views — converting browsers to clicks before they reach the product page

  • Editorial and content teams use key attributes to write product reviews, buying guides, and comparison tables without requiring full product expertise

  • Trade and B2B buyers use attribute data to specify products against technical requirements — procurement without a sales conversation

ACF SETUP

How to configure this field in Accentuate Custom Fields

Where

ACF dashboard → Templates tab → Product scope → Add new field

Label

Key Attributes

Name / Key

key_attributes

Namespace

accentuate (default)

Field type

Shopify >> Single-line text (List)

Multi-value

Yes — 2 to 5 key attributes per product is the recommended range

Note: Key Attributes is a complement to, not a replacement for, specific structured fields. A product with 'Waterproof' as a key attribute should also have 'Waterproof' in its Weather Suitability field. Key Attributes surfaces the most important signals from across all fields in one scannable list — it is the headline summary of a product's structured data.

STEP-BY-STEP IN ACF

  • Open ACF, go to Templates tab and select the Product scope

  • Click 'Add new field'

  • Label: 'Key Attributes' — Key auto-fills as 'key_attributes'

  • Namespace: leave as 'accentuate'

  • Field type: Shopify >> Single-line text (List)

  • Enable 'Allow multiple selections' — 2 to 5 values per product is the recommended range

  • Click Done, then Save

  • For each product, identify the two to five attributes that most directly drive purchase decisions for the target customer — these are not the only good things about the product, they are the deciding ones

Discipline required: Key Attributes loses its value if every product has ten values. The power of this field comes from editorial restraint — 2 to 5 well-chosen attributes that signal the product's core proposition. More than five values is a sign that the field is being used as a description, not as a highlight list.

REFERENCE VALUES

Example values — adapt to your category; these span Home & Living, Outdoor, and Children's products

Value

When to use

Ultralight

Product is significantly lighter than category average — a primary purchase driver for weight-conscious buyers

Packable / Compressible

Product compresses to a significantly smaller size than its deployed volume — key for travel and adventure products

Waterproof

Product has a verified waterproof construction — surfaces this as a headline attribute for weather-dependent categories

Handmade

Product is made by hand — relevant for premium, artisan, and craft positioning

Sustainably sourced

Materials or production process meet a verified sustainability standard — relevant for eco-conscious segments

Quick-dry

Fabric or material dries significantly faster than standard — active wear, travel, outdoor textiles

Odour-resistant

Fabric or material treated or engineered to resist bacterial odour build-up — base layers, activewear

Easy clean

Product surface resists staining and can be wiped down or machine-washed — family, outdoor, and high-use products

Adjustable fit

Product features a fit adjustment system — harnesses, helmets, backpacks, children's items that grow with the user

Foldable / Space-saving

Product folds or stacks to minimise storage footprint — furniture, outdoor gear, travel accessories

Award-winning design

Product has received a recognised design or innovation award — Outdoor Industry Award, Red Dot, Which? Best Buy

Made in [Country]

Country of manufacture is a meaningful purchase signal for this product — premium, provenance, or ethical sourcing context

BEST PRACTICES

  • Choose key attributes from the customer's perspective, not the product manager's — what does the buyer need to know to choose this over a competitor?

  • Keep values short and scannable — 'Ultralight' not 'Designed with an ultralight construction philosophy'

  • Every key attribute should be verifiable — 'Handmade' requires a production process to substantiate it; 'Award-winning design' requires a specific award

  • Review key attributes when a competitor launches a similar product — the attributes that differentiate may change as the competitive landscape shifts

  • Align key attributes with the primary copy and hero images — if the product page leads with 'ultralight', that should be a key attribute

COMMON MISTAKES

  • Using marketing language as attribute values: 'Premium quality', 'Best in class', 'Superior performance' — these are claims, not attributes

  • Duplicating information already in other structured fields without adding value — if 'Waterproof' is in Weather Suitability and visible there, adding it as a key attribute is only useful if it is the product's single most important selling point

  • Assigning more than five key attributes — at six or more, the field becomes a description and loses its signalling power

  • Not updating key attributes when a product's competitive positioning changes

  • Using identical key attributes on every product in a range — if all products have the same attributes, the field cannot differentiate within the range

IN CONTEXT

Ultralight Down Sleeping Bag — 850 Fill

Key attributes

Ultralight, Packable / Compressible, Sustainably sourced, Quick-dry

Activity

Hiking, Mountaineering, Camping

Weight

Packed weight: 680 g, Minimum weight: 610 g

Weather suitability

Cold conditions, Three-season

DEVELOPER IMPLEMENTATION

Liquid note: Shopify >> List — use .value for the array. Render key attributes as a badge strip on both product cards (collection view) and the product page — they are the highest-density conversion signal in the product data set.

Liquid — Storefront Rendering

{% comment %}

Key Attributes — Shopify >> Single-line text (List)

Namespace: accentuate | Key: key_attributes

Render as badge strip on product cards and product page

{% endcomment %}

{% assign attrs = product.metafields.accentuate.key_attributes.value %}

{% if attrs != blank %}

<div class="key-attributes">

{% for attr in attrs %}

<span class="attribute-badge">{{ attr }}</span>

{% endfor %}

</div>

{% endif %}

Pro tip: Surface key attributes on product cards in collection views — not just on the product page. A badge strip of 'Ultralight · Packable · Waterproof' on a collection card converts browsers to product page visits before they have read a single word of product copy.

SEE ALSO

  • Tags (controlled) — key attributes can be mirrored as controlled tags for Shopify-native filtering

  • Compatibility / context — for products where system compatibility is a key attribute, that detail belongs in the Compatibility field

  • All category-specific fields — Key Attributes surfaces the most important values from across all structured fields

Full ACF documentation: help.accentuate.io | Metafield Definitions → Fields → Field data type → Shopify field types

Last updated