HeirloomHelp CenterContact support

Food and drink details

Heirloom has blocks for the details that food and drink customers look for: what’s in a product, where it comes from, how it tastes and any warnings it carries. Each block reads information that you add to the product in your Shopify admin, so one template shows the right details for every product.

Add a food and drink block

Steps:

  1. From your Shopify admin, go to Online Store > Themes.
  2. Find Heirloom, and then click Edit theme.
  3. At the top of the theme editor, open the page selector, and then select Products > Default product.
  4. In the sidebar, under the Product section, click Add block.
  5. Under Food and drink, select a block. For Disclosures, look under Product.
  6. Click Save.

Each of these blocks is hidden on your online store when the product has nothing for it to show. In the theme editor, it shows a short note instead, so you can still select it.

Product attributes

The Product attributes block shows the values of one product attribute, such as dietary preferences or allergens, as one line of text, a list or tags. One line of text, such as “Allergens: Milk, Tree nuts”, is the default. The Food and drink list in Add block has four ready-made versions: Dietary preferences, Allergens, Storage and Taste profile. Add the block more than once to show several attributes.

Where the values come from

The values come from the product’s category metafields. These are the standard attributes that Shopify adds when you give a product a category, such as Coffee or Honey. The attributes that you can fill in depend on the category. Values show in your store’s language, as you’ve named them in your Shopify admin.

Steps:

  1. From your Shopify admin, go to Products.
  2. Click the product that you want to change.
  3. In the Category section, search for the product’s category, and then select it.
  4. In the Category metafields section, fill in the attributes that you want to show, such as dietary preferences and allergens.
  5. Click Save.

Learn more about category metafields in Shopify’s Help Center. To see which metafield each attribute reads, go to Metafields.

Settings

  • Attribute: Values come from the product's category in Shopify admin. Options: Dietary preferences, Allergens, Storage, Taste profile, Flavor, Heat level, Country, Region, Grape variety, Wine sweetness, Wine body, Wine style, Coffee roast, Caffeine content, Tea variety, Honey variety, Oil processing method. Default: Dietary preferences.
  • Label: Leave blank to use the attribute's name.
  • Display: Chips shows each value as a rounded tag. List shows one value per line. Inline shows the label and the values in one line of text, such as "Allergens: Milk, Tree nuts". Options: Chips, List, Inline. Default: Inline.
  • Show icons: Shows an icon beside the dietary values that have one: vegan, vegetarian, plant-based, organic, gluten-free and wheat-free. Values without an icon show as text. This setting shows only for Dietary preferences with Display set to Chips or List, because Inline shows no icons. On by default.

Provenance

The Provenance block shows where a product comes from and who made it: the producer, the region and the vintage or harvest year, as labeled facts, with an optional paragraph under them. A fact that’s blank is left out.

The fields are blank when you add the block. Connect each one to a product metafield, so that every product shows its own producer and region. For example, connect Producer to a custom.producer metafield and Region to custom.origin. Learn more about connecting a metafield to a setting.

Settings

  • Producer: The farm, estate, dairy or maker of the product. Connect it to a single line text metafield.
  • Producer label: The label beside the producer, such as "Distillery", "Roaster" or "Apiary". Leave it blank to show "Producer" in the customer's language. This setting shows once Producer has a value.
  • Region: Where the product comes from, such as a valley, a county or a country. Connect it to a single line text metafield.
  • Region label: The label beside the region, such as "Origin" or "Estate". Leave it blank to show "Region" in the customer's language. This setting shows once Region has a value.
  • Vintage or harvest: The year of the vintage or harvest. Connect it to a metafield, such as a single line text metafield.
  • Year label: The label beside the year. Use Harvest for products such as olive oil, honey and coffee, or Custom to write your own. This setting shows once Vintage or harvest has a value. Options: Vintage, Harvest, Custom. Default: Vintage.
  • Custom year label: Your own label beside the year, such as "Roasted", with Custom selected.
  • Text: A short paragraph under the facts, such as how the product is made. Connect it to a rich text metafield.
  • Display: List shows one fact per row, with the label beside the value. Inline shows the facts in one line, with a thin rule between them. Options: List, Inline. Default: List.

Tasting notes

The Tasting notes block shows the stages of a tasting, such as nose, palate and finish, as rows or as columns. Each stage is a Tasting note inside the block, with a label, a short heading and a paragraph. The tasting product template includes the block, with notes labeled Nose, Palate and Finish.

A note with no heading and no text is hidden, so a label on its own never shows to customers. When every note is empty, the whole block is hidden.

To show each product’s own notes, connect each note’s Heading and Text to product metafields. For example, create one rich text metafield for each stage, such as custom.tasting_palate, and connect each note’s Text to its stage. Learn more about connecting a metafield to a setting.

The block has the same settings on a product page as in the Tasting notes section. Learn more about tasting notes settings.

The Tasting notes section shows tasting notes as a section of their own, for example on a landing page. Learn more about food and drink sections.

Recipe facts

The Recipe facts block shows a recipe’s yield, prep time, cook time and total time, such as “Serves 4”, “20 min” and “70 min”. You can add it to product pages, blog posts and any section that takes theme blocks. A fact that’s blank is left out.

Times are whole minutes. Enter 20, not “20 minutes”, or connect the setting to a number or text metafield. Text that isn’t a number, such as “Overnight”, shows as you wrote it.

Settings

Under Labels, you can rename each fact, for example “Makes” in place of “Yield”. A blank label shows the usual one in the customer’s language.

  • Yield: Servings or amount, shown as written.
  • Prep time (minutes): Whole minutes, or connect a number or text metafield.
  • Cook time (minutes): Minutes of cooking, shown between prep and total.
  • Total time (minutes): Whole minutes, or connect a number or text metafield.
  • Display: Inline shows the facts in one line, each label beside its value. Grid shows each fact as a tile, with the label above the value. Options: Inline, Grid. Default: Inline.

Labels

  • Yield label: Such as Serves or Makes; leave blank to show "Yield".
  • Prep label: Leave blank to show "Prep".
  • Cook label: Leave blank to show "Cook".
  • Total label: Leave blank to show "Total".

Disclosures

The Disclosures block shows the legal warnings that you add to a product, such as a California Proposition 65 warning or a choking hazard notice. It shows them in one row that customers open, with each disclosure’s symbol and title in the row’s summary.

Each disclosure’s title, symbol and text come from the product’s Disclosures metafield, exactly as they’re written in your Shopify admin. Heirloom doesn’t add or change the wording.

Add a disclosure to a product

Steps:

  1. From your Shopify admin, go to Products.
  2. Click the product that you want to add a disclosure to.
  3. In the Product metafields section, click Disclosures, and then select a disclosure, or search for the one that you want.
  4. Click Save.

Learn more about product disclosures in Shopify’s Help Center.

Settings

  • Heading: Leave blank to show "Product disclosures".
  • Open by default: Shows the disclosures open when the page loads. Customers can still close them. Off by default.
  • Show symbols: Shows each disclosure's symbol, such as the Proposition 65 warning symbol, in the summary and beside the disclosure's text. On by default.