Skip to content

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

Product metafield definitions in the Shopify admin

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

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.

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