OGS Allergens and Diet Module
Open Gastronomy Standard — Diet v0.6 (optional module)
1. Purpose
Recommendations are only useful if the guest can eat and drink them. This optional module lets ingredients, dishes and beverages declare their allergens and the diets they suit, so a pairing system can filter before it scores.
The module is optional: a document without dietary is still conformant at every level. A document that includes dietary must follow this module's rules to meet L2.
This information is not a safety guarantee. It does not replace the allergen labelling that law requires (for example EU Regulation (EU) No 1169/2011), and producers remain responsible for the accuracy of what they publish.
2. The dietary Object
Ingredients, dishes and beverages MAY carry a dietary object:
"dietary": {
"contains": ["milk", "sulphites"],
"may_contain": ["tree_nuts"],
"free_from": ["cereals_gluten"],
"suitable_for": ["pescatarian", "gluten_free"],
"provenance": {
"source": "Producer specification sheet",
"confidence": 0.9,
"method": "expert_panel"
}
}
| Field | Type | Description |
|---|---|---|
contains |
array of allergen IDs | Present as an ingredient or processing aid |
may_contain |
array of allergen IDs | Possibly present through cross-contact ("may contain traces") |
free_from |
array of allergen IDs | Positively declared absent |
suitable_for |
array of diet IDs | Diets the item suits |
provenance |
object | Where the information comes from (OGS Core §6) |
Fields not listed are unknown, not absent: an empty or missing contains does not mean "allergen-free". Only free_from asserts absence.
3. Allergens
vocab/allergens.json lists the 14 allergens of EU Regulation (EU) No 1169/2011, Annex II:
| ID | Label | Definition |
|---|---|---|
cereals_gluten |
cereals containing gluten | Wheat (including spelt and khorasan wheat), rye, barley, oats and their hybridized strains, and products made from them. |
crustaceans |
crustaceans | Crustaceans and products made from them, such as crab, lobster, prawn, shrimp, crayfish and langoustine. |
eggs |
eggs | Eggs and products made from them. |
fish |
fish | Fish and products made from them, including fish sauce and anchovy paste. |
peanuts |
peanuts | Peanuts and products made from them. |
soybeans |
soybeans | Soybeans and products made from them, including soy sauce, tofu and miso. |
milk |
milk | Milk from any animal and products made from it, including lactose. |
tree_nuts |
tree nuts | Almonds, hazelnuts, walnuts, cashews, pecans, Brazil nuts, pistachios and macadamia nuts, and products made from them. |
celery |
celery | Celery and products made from it, including celeriac and celery seed. |
mustard |
mustard | Mustard and products made from it, including mustard seed. |
sesame |
sesame | Sesame seeds and products made from them, including tahini and sesame oil. |
sulphites |
sulfites | Sulfur dioxide and sulfites at more than 10 mg/kg or 10 mg/L, expressed as total SO₂. Almost all wine contains them. |
lupin |
lupin | Lupin and products made from it, such as lupin flour. |
molluscs |
mollusks | Mollusks and products made from them, such as mussels, oysters, clams, scallops, squid, octopus and snails, and oyster sauce. |
Wines and most beers declare sulphites; beers brewed from barley or wheat declare cereals_gluten.
4. Diets
vocab/diets.json lists the supported diets. Each declares the allergens, and from v0.6 the ingredient categories (OGS Composition §7.2), that a document claiming the diet must not contain:
| ID | Label | Definition | Must not contain (allergens / categories) |
|---|---|---|---|
vegan |
vegan | Contains no animal products: no meat, poultry, fish, seafood, dairy, eggs or honey. | milk, eggs, fish, crustaceans, molluscs / meat, poultry, fish, seafood, egg, dairy |
vegetarian |
vegetarian | Contains no meat, poultry, fish or seafood, nor products made from them such as gelatin or animal rennet; may contain dairy and eggs. | fish, crustaceans, molluscs / meat, poultry, fish, seafood |
pescatarian |
pescatarian | Contains no meat or poultry; may contain fish, seafood, dairy and eggs. | — / meat, poultry |
gluten_free |
gluten-free | Contains no cereals containing gluten, or only gluten-free versions of them. In the EU a food labeled gluten-free has at most 20 mg/kg of gluten. | cereals_gluten / — |
dairy_free |
dairy-free | Contains no milk or milk products from any animal. | milk / dairy |
alcohol_free |
alcohol-free | Contains no more than 0.5% alcohol by volume. Some markets set a lower limit for the label, such as 0.05% in the UK. | — / alcohol |
lactose_free |
lactose-free | Contains no lactose, or less than the limit a market sets for lactose-free labeling. Lactose-free dairy still contains milk proteins, so it is not dairy-free. | — / — |
Allergens and categories still cannot express every diet rule. Gelatin, animal rennet, honey, lard and dripping (category fat) and meat or fish stock (category other) pass both checks. A producer claiming vegetarian or vegan remains responsible for those facts. For example, the OGS reference Parmigiano-Reggiano does not claim vegetarian, because it is made with animal rennet.
Oats made gluten-free under Regulation (EU) No 828/2014 still declare cereals_gluten under Annex II, so they cannot yet claim gluten_free here; a later version may add a way to express it.
lactose_free (new in v0.6) excludes no allergen: lactose-free dairy still contains milk proteins, so a lactose-free product can declare contains: ["milk"] and claim lactose_free, but not dairy_free.
Religious and certification-based classifications, such as halal and kosher, remain out of scope (OGS Core §1.2): they depend on certification, not on composition.
5. Conformance
| Level | Requirement |
|---|---|
| L1 | dietary matches the schema (common.schema.json#/$defs/dietary). |
| L2 | Every allergen and diet ID is in its vocabulary. No allergen in free_from also appears in contains or may_contain. A suitable_for diet contains none of the allergens it excludes. From v0.5, a beverage claiming alcohol_free declares an abv of at most 0.5. From v0.6, an ingredient claiming a diet is not in a category that diet excludes. |
When a dish is validated together with its ingredients, validators SHOULD warn when an ingredient contains an allergen that the dish does not declare. From v0.5 this includes the ingredients of its sub-preparations (OGS Composition §6.3). From v0.6 they SHOULD also warn when a dish claims a diet that excludes the category of one of those ingredients.
6. References
- OGS Core — Core specification (scope, provenance, conformance)
vocab/allergens.json,vocab/diets.json— Vocabularies- Regulation (EU) No 1169/2011 on the provision of food information to consumers, Annex II