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