Help CenterContact support
All Custos: EU Compliance articles

How do I add a food label to a product?

Updated

On this page
  1. Before you start
  2. Steps
  3. Food supplements
  4. Products whose variants are different foods
  5. Filling the label from packaging text
  6. Starting from a similar product
  7. Drafts and published labels
  8. Restoring the previous published version
  9. When the label changed in another tab
  10. Products exempt from the nutrition declaration
  11. Editing several labels at once
  12. Adding labels from a CSV file
  13. Reviewing the label
  14. Troubleshooting
  15. Removing a label

This guide shows how to add the nutrition table, ingredients, allergens and other food information to a product, so it can be shown on the product page.

Before you start

Enter your operator name and address in Settings. They are shown on every food label.

Steps

  1. In the app, open Food labels.

  2. Find the product (use Search products, or the All, Labeled and Not labeled tabs) and click its name or the edit button on its row. You can also click Add label at the top of the page and pick the product.

  3. The editor has your label fields on the left. The right-hand column holds Publishing, Copy label and the Label preview, which updates as you type.

  4. Under Nutrition declaration, choose whether values are given Per 100 g or Per 100 ml, then answer Is a nutrition declaration required?:

    • Required: fill in energy (kJ and kcal), fat, saturates, carbohydrate, sugars, protein and salt. Fibre is optional. 0 is a value and is shown as 0 g; an empty field is not.
    • Not required: the product is exempt: enter the reason, for example “unprocessed product with a single ingredient”. The reason is required.
    • Not reviewed yet: you have not decided. The label is flagged for review until you do.

    Optional, under the values: Portion size (in g or ml) adds a “per portion” column, for example 40 for a 40 g serving. Show % of reference intake (%RI) adds a column with each value as a share of the reference intakes of an average adult (Regulation (EU) 1169/2011, Annex XIII, Part B: 8 400 kJ/2 000 kcal, fat 70 g, saturates 20 g, carbohydrate 260 g, sugars 90 g, protein 50 g, salt 6 g), per portion when a portion size is set, else per 100 g or 100 ml. The storefront adds “Reference intake of an average adult (8 400 kJ/2 000 kcal)” under the table in the shopper’s language. Per-portion amounts are rounded as the European Commission’s guidance on tolerances recommends. A label without these fields shows the table as before.

  5. Under Name and ingredients:

    • Name of the food: the legal or customary name, for example “Hazelnut spread with cocoa”. A brand name does not replace it.
    • Ingredients: wrap each allergen in asterisks to show it in bold, for example *Wheat* flour, *milk*, sugar.
    • Possible allergens in the ingredients: as you type, the app looks for words of the 14 allergen groups in English, German, French, Italian, Spanish, Dutch and Polish (for example “Weizenmehl”, “lait”, “noix de cajou”) and lists the ones that are not emphasised and the groups missing from Allergens. Bold these words wraps them in asterisks; Add to allergens ticks their groups. Nothing changes until you click, and Dismiss hides the suggestion until the text changes. The suggestions come from a word list: they can miss an allergen or name a word that is not one (the app knows, for example, that cocoa butter and coconut are not milk or nuts), so always check them against your recipe.
    • Quantity of ingredients (QUID): when an ingredient is named, emphasised or pictured, enter its quantity, for example Hazelnuts 13%, and choose where it is declared: in the ingredients list (the storefront does not repeat it), next to the food name (shown in brackets after the name) or as a separate line.
  6. Under Allergens and diet:

    • Allergens: select every EU Annex II allergen the ingredients contain. For Cereals containing gluten and Tree nuts, also tick the specific cereal (wheat, rye, barley, oats, spelt, Khorasan wheat) or nut (almonds, hazelnuts, walnuts, cashews, pecans, Brazil nuts, pistachios, macadamias). The storefront shows them as, for example, “Cereals containing gluten (Wheat, Oats)”.
    • Contains statement: allergens declared with “Contains” instead of in an ingredients list, for example for a product sold without one. They are not added to the ingredients. This group is closed until you use it: click it to open it. Its title shows how many allergens are selected.
    • May contain: a precautionary statement for possible cross-contact. It is shown on its own line and is never added to the ingredients or to the allergens the product contains. Like Contains statement, it is closed until you use it.
    • Diet: optional diet claims shown as badges. See allergen icons and diet badges.
  7. Under Additional information, you can add net quantity, alcohol by volume, storage conditions, country of origin and instructions for use. Tick Mixed pack when the product is several different products sold together at one price; no unit price is then set for it (see setting unit prices).

  8. Optional: click Operator override to open it, then enter a different operator name and address for this product only. Leave both fields empty to use the operator from Settings.

  9. Click Save. You will see “Draft saved”. A draft is not shown to customers.

  10. In the right-hand column, under Publishing, click Publish and show on store (or Publish as revision N for a label that is already live). The app lists each point that needs your judgement, for example “Compare the ingredients with the declared allergens” or translations written for older text. Tick each one after checking it against your source; a single checkbox for everything is not offered. Optionally note the source, for example “Supplier specification v3”. Then click Publish and show on store (Publish to storefront for a new revision). You will see “Label published”. After a first publish the editor checks whether the label shows on the product’s page and opens the theme editor when the block is missing; see setting up the app.

The label only appears on your storefront once the Food information block is added to your product template.

Food supplements

For a food supplement (vitamins, minerals or other substances sold in doses, such as capsules or tablets), choose Food supplement under Product type at the top of the declaration section. The section becomes Food supplement declaration and replaces the nutrition table, which a food supplement does not carry (Regulation (EU) 1169/2011, Art. 29):

  1. Recommended daily dose: as on the pack, for example “1 capsule a day”. Every amount below is per this dose.
  2. Click Add nutrient for each vitamin, mineral or other substance. Choose it under Nutrient and enter its Amount per daily dose:
    • A vitamin or mineral uses the unit of its nutrient reference value (NRV), and the app shows its % NRV as you type, for example “200% of the nutrient reference value (5 µg)” for 10 µg of vitamin D. The reference values are those of Regulation (EU) 1169/2011, Annex XIII, Part A.
    • Other substance: enter its name and unit (mg, µg or g). It is shown without a % NRV.
  3. The storefront adds the mandatory statements of Directive 2002/46/EC: do not exceed the recommended daily dose, food supplements are not a substitute for a varied diet, and keep out of the reach of young children. Change their wording, or the names of the nutrients, in Settings > Translations (group Food supplements).

Name the product as the law requires: the name must include “food supplement” and the categories of nutrients or substances it contains, for example “Food supplement with vitamin D3”. Ingredients, allergens, net quantity and the operator stay as for any other food.

To turn the product back into an ordinary food, choose Food: the supplement declaration is removed when you save.

Products whose variants are different foods

By default every variant of a product shows the product’s label. If the variants are different flavours or pack sizes, choose Variants differ under Variants and set the label of each variant: the product label, the product label with its own net quantity, or a label of its own. See “How do I show a different food label for each variant?” (variant labels).

Filling the label from packaging text

Above the label fields, click Fill from packaging text to open it. Paste the text from the pack or your supplier’s spec sheet: the nutrition table, the ingredients and any “Contains” or “May contain” lines, in any of the storefront languages (English, German, French, Italian, Spanish, Dutch, Polish, Portuguese, Swedish, Danish). Values may use a decimal comma or point, and energy may be given in kJ and kcal. Click Read text.

The app lists what it found (values per 100 g or 100 ml, ingredients with their allergens in bold, “Contains” and “May contain” allergens) and the fields it did not find, which keep their current value. A value printed as “<0.5 g” or in mg is left blank and listed under Check these values: enter it yourself. Click Apply to label to fill the form, check every field against the pack, then click Save. Nothing is published until you publish, and the publishing checks run as usual.

The text is read by fixed rules in your browser, not by AI: a pack laid out unusually may be read only in part, so always compare the result with your source.

Starting from a similar product

In the right-hand column, under Copy label, click Copy from another product and pick a labelled product. Its label fills the form, translations included. If your form already has values, the app asks before replacing them. Nothing is saved until you click Save; check the allergens and nutrition values first.

Drafts and published labels

  • Save keeps your changes as a draft. Customers keep seeing the published label until you publish.
  • Publish updates the label customers see. Fields with errors (for example a negative number, unclosed asterisks, or an exemption without a reason) must be fixed first.
  • The Publishing section shows the live revision number, when and by whom it was published, its source note, and whether a draft is waiting. The product list shows a Draft badge for products with unpublished changes.
  • Discard draft deletes the unpublished changes; the form shows the published label again.
  • Labels created before drafts existed count as published (revision 1) and keep showing on your storefront.
  • “Published” records your decision. It is not a legal certification of the label.

Restoring the previous published version

Each time you publish a label that differs from the live one, the app keeps the live one as the previous version. To put it back:

  1. Open the product’s label and, under Publishing, click Restore previous published version. Save or discard unsaved changes in the form first.
  2. The app shows the previous revision, when and by whom it was published, and a table of every field that changes: Live now next to After restoring.
  3. Click Restore revision N. The storefront shows that version again as a new revision marked “Restored from revision N”.

The label you replaced becomes the previous version, so you can restore it again to undo. A draft you are working on is not changed. Only the last published version is kept, not the full history. If your recipe changed, publish a corrected label instead of restoring an older one for products you still sell.

When the label changed in another tab

If the label was saved somewhere else after you opened it (another browser tab, a CSV import or another staff member), Save, Publish and Discard draft write nothing. Instead the editor shows This label was changed somewhere else with a table of every field that differs: Your version next to Saved meanwhile. Choose:

  • Keep my version: your version is written on top of the other one.
  • Use the saved version: the editor loads the other version and your unsaved edits are dropped.

The app never silently overwrites a change made elsewhere. See “Why doesn’t the food label show on my product page?”

Products exempt from the nutrition declaration

Choose Not required: the product is exempt and enter the reason only after verifying that an exemption applies to this specific product. An empty table on its own does not confirm an exemption: the app shows it as Not reviewed yet until you choose. Check the European Commission nutrition guidance and any product-specific rules.

Editing several labels at once

In Food labels, select the products and click Edit labels. Choose one field:

  • Allergens or May contain: add the allergens you tick to the ones each label already has, or replace the list on every label.
  • Storage conditions: replaces the text on every label. Translations of the old text are marked for review.
  • Food business operator: set the same operator on every label, or use the store’s default operator from Settings.

The dialog says how many labels will change; selected products without a label are skipped. Click Save N drafts: each label is saved as a draft, and customers keep seeing the published label until you publish it from its editor. A label changed somewhere else after the list loaded is left as it is and named in a banner. Bulk edit changes the products’ own labels, not the labels of variants.

Adding labels from a CSV file

In Food labels, click Import CSV and download the template: it has one row per product and one column per field. Allergen columns (allergens, contains, may_contain) take codes separated by |, for example gluten|wheat|milk; the cereal and nut codes are wheat, rye, barley, oats, spelt, kamut, almond, hazelnut, walnut, cashew, pecan, brazil, pistachio and macadamia. nutrition_status is required, exempt or not_reviewed (empty means required when values are filled in), with the reason in nutrition_exemption. quid_location is ingredients, name or separate. portion_size is the portion in g or ml (empty for none) and show_ri is yes or empty. A food’s optional vitamins and minerals go in nutrition_extra: entries separated by |, each as code:amount:unit per 100 g or 100 ml in the unit of its reference value, for example vitamin_d:1.5:µg|calcium:120:mg. An empty nutrition_extra cell keeps the stored vitamins and minerals in both update modes; [clear] removes them. For a food supplement, set label_type to supplement (empty means a food), the dose in daily_dose, and the amounts in supplement_nutrients: entries separated by |, a vitamin or mineral as code:amount and another substance as name:amount:unit, for example vitamin_d:10|zinc:5.5|Coenzyme Q10:30:mg. The codes are those of the export, for example vitamin_a, vitamin_b12, folic_acid, calcium, iron, zinc, iodine. The US Nutrition Facts have one column per field: fda_serving_size_text, fda_servings_per_container, fda_calories, fda_total_fat, fda_sat_fat, fda_trans_fat, fda_cholesterol_mg, fda_sodium_mg, fda_total_carb, fda_fiber, fda_total_sugars, fda_added_sugars, fda_protein, fda_vitamin_d, fda_calcium, fda_iron and fda_potassium, with the amounts per serving as in the editor. A filled fda_ cell switches the US Nutrition Facts on; in “Replace label” mode a row with every fda_ cell empty switches them off. A food supplement has no US Nutrition Facts.

Rows can be matched by product ID, handle or SKU, and an import can replace whole labels or update only the fields you fill in ([clear] empties a field). See importing labels from a CSV file for matching, update modes, the 1,000-row limit and how to continue an interrupted import.

Before importing, choose what the import does: Save as drafts (the default; customers see nothing until you publish each label from its editor) or Publish the rows without errors. The preview counts the rows that replace a draft, the published labels that change, and, when publishing, the rows that go live with review points still open. A row you did not change from an export never replaces a draft: the export carries the published label, and Discard draft in the editor is the way to drop a draft. Publish the rows without errors replaces the published label with the row and leaves any draft waiting in the editor; it never publishes a draft’s content. After the import, the result lists every line that was written and every line that was not, with the reason. A line whose label was changed after the file was checked (for example in the editor in another tab) is not written; click Check the file again to see a new preview against the current labels.

The variant_id and variant_override columns write the label of a variant instead of the product’s; see variant labels. Leave them empty for product labels.

Files exported before the food_name, nutrition_status, nutrition_exemption, contains, may_contain, quid, quid_location, instructions, diet, label_type, daily_dose, supplement_nutrients, portion_size, show_ri, nutrition_extra and fda_ columns existed still import: a column that is missing from the file keeps each product’s stored value, and a file without any fda_ column keeps the stored US Nutrition Facts.

Reviewing the label

Needs review means no structural issue was detected, not that the food information is verified. Compare the ingredients with your source, check the declared allergens and emphasise the relevant ingredient names. Bold text or an empty allergen selection does not verify allergen content. Publishing asks you to confirm each of these points; it records your decision, not an approval by the app.

The admin product block and Sidekick distinguish structural issues from these manual checks. An empty nutrition table prompts an exemption check.

Troubleshooting

  • “Fix the highlighted fields and try again”: a field has an invalid value. Nutrition values must be numbers of 0 or more, an exemption needs a reason, a quantity (QUID) needs a location, and the operator name and address must both be filled in if you use an override.
  • Ingredient emphasis error: close every asterisk pair and remove empty pairs. Both the editor and CSV import reject unclosed or empty pairs.
  • Allergen not bold: check that each relevant ingredient name is wrapped in asterisks on both sides. The allergen suggestions under Ingredients help, but they come from a word list and do not verify the recipe.

Removing a label

In Food labels, use the remove button on the product’s row, or select several products and click Remove labels. The published label, its draft, its previous version and its revision record are deleted, together with the labels its variants have of their own, so the block stops showing any label for that product on the storefront. This can’t be undone.

You can also click Remove label at the bottom of the product’s editor. There it removes only the label you are editing: the product’s own label keeps the variants’ own labels, and a variant’s label leaves the product’s label and the other variants as they are (see variant labels).

Built and supported by StoreFleet, Shopify app developers since 2021.