Metafields reference

Kelvin works with none of these: each row, box, badge or check hides when its field is empty. Create product definitions in Settings → Custom data → Products → Add definition (turn on storefront access), then fill them in on each product under Metafields.

Specs (namespace `specs`)

Key	Type	Where it shows
Any key listed in Spec rows	Single line text	Spec rows on cards (the first ones a product has), the compare table, the product page’s spec table, and filters through Search & Discovery. See Spec rows.
`summary`	Single line text	A short spec line in search suggestions, the hero, bundles, vertical film links and menu promos.
The key in a hero readout’s Specs metafield key	Single line text	That readout’s value in the Hero, such as `battery_life`. On install the readouts read `polling_rate`, `battery_life`, `connectivity` and `layout`; a readout with no value hides.
`highlights`	List of single line text, or rich text	The Overview block on the product page.
`specifications`	Multi-line text	Extra spec table rows, one `Label: value` per line.
`in_the_box`	List of single line text	The In the box block, and the hero.
`compatibility`	List of single line text	The Works with block; models offered by the Compatibility finder.
`compat_note`	Single line text	A note in the product page’s compatibility box.
`setup`	Multi-line text	Setup steps, one per line.
`manual`	File	A download under Setup and downloads.
`spec_sheet`	File	A second download under Setup and downloads.
`materials`	Multi-line text	Materials and repair, one `Label: value` per line.
`size_chart`	Multi-line text	The Size and fit side panel, one `Label: value` per line.
`badge`	Single line text	A custom badge on cards and the product page.

PC Builder (namespace `specs`)

The PC Builder’s checks read these keys per part type. The tables in PC Builder give each key’s type, unit and the check it feeds.

Part type	Keys (namespace `specs`)
Processor	`socket`, `generation`, `memory_types`, `max_memory_gb`, `max_memory_speed_mhz`, `peak_power_w`, `has_igpu`, `includes_cooler`
Motherboard	`socket`, `cpu_generations`, `bios_update_generations`, `form_factor`, `memory_type`, `memory_slots`, `max_memory_gb`, `max_memory_speed_mhz`, `m2_slots`, `sata_ports`, `connector_layout`, `front_usbc_header`, `chipset`
Memory	`memory_type`, `module_count`, `capacity_gb_total`, `speed_mhz`, `module_height_mm`
Graphics card	`gpu_length_mm`, `gpu_slot_width`, `tdp_w`, `recommended_psu_w`, `gpu_12v_2x6`, `adapter_included`, `gpu_pcie_8pin_count`
Storage	`storage_kind`, `capacity_gb`
Power supply	`psu_w`, `psu_form_factor`, `psu_12v_2x6_count`, `psu_pcie_8pin_count`
Case	`form_factors`, `max_gpu_length_mm`, `expansion_slots`, `max_cooler_height_mm`, `radiator_sizes_mm`, `max_radiator_mm`, `psu_form_factors`, `connector_layout`, `front_usbc`, `fans_included`
CPU cooler	`cooler_type`, `socket_support`, `cooler_height_mm`, `radiator_size_mm`, `max_tdp_w`, `ram_clearance_mm`
Case fans	`fan_count`

Other product fields

Namespace and key	Type	Where it shows
`custom.protection_plans`	List of product references	Care+ plans on the product page and in the cart. See Care+ protection plans.
`custom.reviews`	List of metaobject references (type `customer_review`)	Review cards with the Verified purchase badge. See Product reviews and Verified purchase.
`custom.badge`	Single line text	A custom badge, when `specs.badge` is empty.
`reviews.rating`, `reviews.rating_count`	Rating, integer	Stars on cards and the product page, written by a reviews app.
`shopify--discovery--product_recommendation.complementary_products`	Product references	Frequently bought together on the product page and suggestions in the cart, set in the Search & Discovery app.

Blog posts

Namespace and key	Type	Where it shows
`custom.reading_time`	Integer (minutes)	The reading time on blog cards, the blog page and the article. Without it, Kelvin estimates the time from the length of the post (about 220 words a minute). Create it under Settings → Custom data → Blog posts.

Metaobject: Product review

Field	Key	Type
Rating	`rating`	Integer (1 to 5) or rating
Title	`title`	Single line text
Review	`body`	Multi-line text
Author	`author`	Single line text
Date	`date`	Date
Verified purchase	`verified`	True or false
Used for	`used_for`	Single line text

Create it in Settings → Custom data → Metaobjects with the type customer_review and the name Product review. See Product reviews and Verified purchase.

Tag	Set in	What it does
`bestseller`	Theme settings → Badges → Best seller tag	The Best seller badge.
`preorder`	Theme settings → Badges → Pre-order tag	Pre-order badge and button, `Pre-order` line property.
`pc-part`	Theme settings → PC Builder → Parts tag	Add to a PC build on the product page.

Getting started

Theme settings

Header and footer

Home page

PC Builder and compare

Product page

Collections and search

Cart

Content pages

Blog

Account and utility pages

Overlays

More sections

Feature guides

Help

Specs (namespace `specs`)

PC Builder (namespace `specs`)

Other product fields

Blog posts

Metaobject: Product review

Tags

​Specs (namespace specs)

​PC Builder (namespace specs)

​Other product fields

​Blog posts

​Metaobject: Product review

​Tags

Specs (namespace `specs`)

PC Builder (namespace `specs`)

Other product fields

Blog posts

Metaobject: Product review

Tags