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 |
|---|
