The US has nine major food allergens: milk, egg, fish, crustacean shellfish, tree nuts, wheat, peanuts, soybeans and sesame. A packaged food's label must declare each one it contains, either in a "Contains" statement or in parentheses in the ingredient list, naming the specific tree nut, fish or shellfish. Online shoppers can't read the label, so put the same allergen line on each Shopify product page. A product metafield is the tidy way: one field per product, shown by the theme, and usable as a storefront filter.
This is general information, not legal advice.
The short version
- Nine major allergens: milk, egg, fish, crustacean shellfish, tree nuts, wheat, peanuts, soybeans, sesame.
- Label: a "Contains" line, or the source in parentheses in the ingredients.
- Name the specific tree nut (almond, macadamia), fish (tuna) or shellfish (shrimp).
- On Shopify: a product metafield for allergens, shown on the product page.
- Keep the page and the label from the same source, so they never disagree.
On the label
| Way | Example |
|---|---|
| Contains statement | Contains: wheat, milk, egg, macadamia nuts. |
| In the ingredients | Flour (wheat), butter (milk), eggs, macadamia nuts |
Allergens in flavorings, colorings and incidental additives count too. Food allergen labeling requirements covers the rules in depth.
On the Shopify product page
- Settings > Custom data > Products > Add definition. Name it "Allergens".
- Choose a type: a list of single-line text, or a list from fixed choices (the nine allergens), which keeps spelling consistent.
- Fill it in on each product.
- In the theme editor, add the metafield to the product page, near the ingredients.
With fixed choices, many themes and Shopify's Search & Discovery app can use the metafield as a filter, so a shopper can hide products with peanuts.
A made-up example
Kaimukī Cookie Co. sells 14 cookies. Each recipe lists its allergens; the label's Contains line and the product metafield both come from it. When the chocolate chunk recipe switches to a chip made on shared equipment with peanuts, the owner updates the recipe, reprints labels, and changes the metafield the same day. A "may contain" line is voluntary under federal rules, so the owner decides how to word it on both.
Where the page and the label drift apart
- A recipe changes; the label is reprinted; the page isn't.
- A seasonal variant has a different ingredient; the product page shows the main variant's allergens.
- Allergens are typed into each description by hand, with different spellings.
Shopify product ingredients covers keeping ingredient lists and allergens in one place.
Where this stops working
A metafield shows what you typed. It doesn't know what's in the recipe, so a changed ingredient doesn't change the page. And allergen control in the kitchen (separate storage, cleaning between runs, the order of batches) is a record Shopify doesn't keep. Shopify recipes covers keeping allergens with the recipe.
How TaroStack does it
TaroStack for Shopify runs inside your Shopify admin and keeps allergens with each ingredient and recipe, so a product's allergens follow its recipe version. Batches record which ingredient lots they used, which helps if an allergen problem comes from a supplier. It keeps records; it doesn't write labels or make you compliant. Free for 14 days.
