Food products module

Selling food online requires providing information about composition, nutritional values, allergens and product origin (EU Regulation 1169/2011). Polski for WooCommerce provides a complete module for managing this data.

Legal requirements

The FIC Regulation obliges food sellers to provide the following information:

Information	Required	Legal basis
Food name	Yes	Art. 9(1)(a)
List of ingredients	Yes	Art. 9(1)(b)
Allergens	Yes	Art. 9(1)(c)
Quantity of ingredients	Conditional	Art. 9(1)(d)
Net quantity	Yes	Art. 9(1)(e)
Date of minimum durability	Yes	Art. 9(1)(f)
Storage conditions	Conditional	Art. 9(1)(g)
Producer data	Yes	Art. 9(1)(h)
Country of origin	Conditional	Art. 9(1)(i)
Nutritional value	Yes	Art. 9(1)(l)

For distance selling (online store), most of this information must be available before purchase - except the date of minimum durability, which can be provided upon delivery.

Module components

The food module consists of several sub-modules that can be enabled independently:

Nutritional values

Nutrition facts table per 100 g or 100 ml of product. Includes energy (kJ/kcal), fats, carbohydrates, protein, salt and other nutrients.

Details: Nutritional values

Allergens

Allergen declaration system based on WordPress taxonomy. 14 main allergens according to Annex II of the FIC Regulation.

Details: Allergens

Nutri-Score

Display of Nutri-Score labels (A-E) with appropriate colors and CSS classes.

Details: Nutri-Score

Ingredients (list)

Text field for the full product ingredients list. Allergens in the list are automatically highlighted in bold according to FIC requirements.

Alcohol

Fields for managing information about alcoholic products:

Field	Description
Alcohol content (% vol.)	Percentage alcohol content
Warning	Message about prohibition of sale to minors
Age verification	Checkbox for confirming legal age when adding to cart

For beverages with an alcohol content above 1.2% vol., indicating the alcohol content on the label is required (Art. 28 FIC).

Country of origin

Field for country of origin or place of provenance information. Required for:

meat (beef, pork, poultry, lamb)
fruits and vegetables
fish
olive oil
honey
products where lack of information could mislead the consumer

Configuration

Enabling the module

Go to Polski > Settings > Content & Trust and activate the module and select the sub-modules you need.

Global settings

Setting	Description
Reference unit	Default unit: per 100 g or per 100 ml
Position on product page	Where to display information (tab, below description, sidebar)
Display on listing	Whether to show condensed information on category pages
Automatic allergen highlighting	Bold allergen names in the ingredients list

Position on the product page

Food product information can be displayed in several places:

New tab (recommended) - separate “Food Information” tab next to description and reviews
Below description - directly below the product description
In metadata - in the SKU/categories section
Custom - using shortcodes anywhere

Product editor

There is no separate “Food” tab in the product editor. Allergens are the one food field edited there: the module registers a polski_allergen taxonomy on products, so an Allergens box appears in the product sidebar and you tick the terms that apply.

Every other value (nutrition table, ingredients, Nutri-Score, alcohol content, place of origin, distributor, net content) is stored as product meta and is set through the CSV columns below, or programmatically.

CSV import

All food data can be imported in bulk via CSV:

CSV column	Description	Format
`polski_nutrients`	Nutritional values	JSON
`polski_ingredients`	Ingredients list	Text
`polski_nutri_score`	Nutri-Score	Letter A-E
`polski_alcohol_content`	Alcohol content	Number (e.g. `5.0`)
`polski_place_of_origin`	Country or place of origin	Text
`polski_food_distributor`	Distributor	Text
`polski_net_filling`	Net content	Text

Example:

"Orange juice 1L",'{"energy_kj":180,"energy_kcal":43,"fat":0.1,"carbohydrates":9.8,"sugars":8.4,"protein":0.7,"salt":0.01}',,"",B,,Spain

Schema.org compatibility

The module automatically generates Schema.org-compliant structured data:

{
    "@type": "Product",
    "additionalProperty": [
        {
            "@type": "PropertyValue",
            "name": "Energy value",
            "value": "250 kcal / 1046 kJ"
        }
    ],
    "hasAllergen": ["gluten", "milk"],
    "countryOfOrigin": {
        "@type": "Country",
        "name": "Poland"
    }
}

Programmatic extensions

Adding a custom food field

add_filter('polski/food/custom_fields', function (array $fields): array {
    $fields['organic_certified'] = [
        'label'   => 'Organic certificate',
        'type'    => 'select',
        'options' => [
            ''       => 'None',
            'eu_bio' => 'EU Bio',
            'demeter' => 'Demeter',
        ],
    ];

    return $fields;
});

Food information display filter

add_filter('polski/food/display_html', function (string $html, int $product_id): string {
    // Modify HTML before display
    return $html;
}, 10, 2);

Common issues

Food details do not appear on the product page

Check that the food module is enabled in Polski > Modules, that toggle is what the storefront block reads
Check the per-field switches in the same module (Show ingredients, Show allergens, Show nutrition facts table and the rest)
Confirm the product actually carries the data. Apart from allergens there is no “Food” tab to type it into, the values arrive by CSV import. Product type is not a factor: the plugin’s product data tab renders for simple, variable and external products alike

Allergens are not bolded in the ingredients list

Make sure the “Automatic allergen highlighting” option is enabled and that allergen names in the list match names in the taxonomy.

Nutritional values display incorrectly

Check the data format - values must be numbers (with a dot as the decimal separator in the database). The plugin automatically formats the display according to Polish regional settings (comma).

This page is for informational purposes only and does not constitute legal advice. Consult a lawyer before implementation. Polski for WooCommerce is open source software (GPLv2) provided without warranty.