Product, collection, article and page data
The theme reads these metafields so each product can carry its own flavor, colors and copy. Create the definitions in Settings → Metafields and metaobjects. All of them are optional: when one is empty, the part that uses it is hidden or falls back to a block setting or to Shopify’s own data (for example the page content for page cards, or the article’s author for the author box).

The metafields
Section titled “The metafields”| Owner | Metafield | Type | Where it shows |
|---|---|---|---|
| Product | custom.flavor |
Single line text | Under the product name on cards and the product page |
| Product | custom.subtitle |
Single line text | Used instead of custom.flavor when that is empty, for example “Balance bike, 2.9 kg” |
| Product | custom.card_tag |
Single line text | Short tag next to the price on cards, for example an age range “3–5 yrs” |
| Product | custom.materials, custom.care, custom.specs |
Multi-line text | Collapsible content rows whose Start with product data is set to Materials, Care or Size and specs on the product page |
| Product | custom.tint |
Color | Card and gallery background |
| Product | custom.tone |
Color | Swatch color of the product among its sibling formulas |
| Product | custom.badges |
JSON (structured text; copy the example and change the words), for example [{"style":"new","text":"New"}]; style sets the color: new the accent color, vegan lime, and any other word (for example bestseller) a dark badge in the text color (a white one for bestseller on Photo and Inset photo cards) |
Badges on cards and the product page |
| Product | custom.sale_label |
Single line text | Text of the sale badge |
| Product | custom.savings_label |
Single line text | Saving line in the cart |
| Product | custom.perks |
JSON, for example [{"icon":"leaf","text":"0 g sugar"}]; icon names are listed below the table |
Benefit lines on the product page and cards |
| Product | custom.perk |
Single line text | One short benefit line on cards and article product picks |
| Product | custom.facts |
JSON rows of name, amount and daily value, for example [["Vitamin C","60 mg","67%"]] |
Supplement facts popup |
| Product | custom.serving_size, custom.servings |
Single line text, integer | Supplement facts popup; servings also sets the “days of supply” beside the unit price and in quick view |
| Product | custom.other_ingredients, custom.facts_note |
Multi-line text | Supplement facts popup |
| Product | custom.how_to |
Multi-line text | “How to take” fold |
| Product | custom.siblings |
Product list | Product swatches block and card dots |
| Product | custom.cutout |
True or false | True for pack shots on a transparent background, shown without a frame. Set it to false for photos that should fill the product card |
| Product | custom.pack_note |
Single line text | Pack note under the title |
| Product | custom.ships_on |
Date | Pre-order ship date (see Buy buttons, stock and delivery) |
| Product | custom.bundle_items |
Product list | Bundle contents block |
| Product | custom.set |
Product list | Product set block; the block’s own product picks are used when empty |
| Product | custom.pairings |
Product list | Complementary products block; the block’s own picks are used when empty |
| Product | custom.size_chart |
Page reference | The product’s own size chart in the Variant picker help popup |
| Product | custom.story |
Single line text: the blog’s handle, a slash and the article’s handle (the last part of their web addresses), for example journal/a-better-morning |
Journal story on the product page; the block’s chosen article is used when empty |
| Variant | custom.units |
Integer | Jars in a pack, for the per-jar price |
| Product | reviews.rating, reviews.rating_count |
Shopify’s standard review metafields | Stars and review count, filled by most reviews apps |
| Product | custom.review_split |
Integer list with 5 values: the counts of 5, 4, 3, 2 and 1 star reviews, for example [40, 12, 3, 1, 1] |
Bars per star rating in the Review summary block; the bars stay hidden without it |
| Collection | custom.tint, custom.highlight, custom.nav_title, custom.jars |
Color, text, text, product list | Collection card tint, highlighted heading word, short title in collection links and search results, jar photos on collection links |
| Collection | custom.badge, custom.badge_color |
Single line text (for example an age range “3–5”), color | Age cards in Collection links with Photo style: Age cards for collections with a badge: the badge text in a colored circle |
| Collection | custom.summary |
Multi-line text | Second line of age tab cards in Popular products and of bento cards in Collection list |
| Article | custom.read_time, custom.author_avatar, custom.author_bio, custom.featured_product |
Text, file, multi-line text, product | Reading time, author box, featured product in the article |
| Article | custom.shop_text, custom.shop_products |
Multi-line text, product list | Text and products of the Shop this story row under the article; the row is hidden when it has no products. The theme does not read these two by itself: connect them as described in Blog and blog posts |
| Page | custom.icon, custom.tint, custom.summary |
Text (an icon name), color, multi-line text | Page cards in search results |
Icon names
Section titled “Icon names”For custom.perks: truck, lock, return, chat, mail, phone, leaf, drop, heart, flask, sparkle, shield, gift, star, smile, check-circle, clock, calendar, pin, store, box, zoom, plus, repeat, percent, tag, moon, sun, bolt, jar, wallet, medal.
Good to know
Section titled “Good to know”- Several product page blocks read these metafields (perks, facts, sibling products, card tags) and stay hidden while the metafield is empty. If a block does not show, check the table for the metafield it needs.
- Metaobjects are not read by the theme.