Documentation

Everything you need to get started with WooNutri

Installation

WooNutri can be installed in two ways:

1 From WordPress.org (Recommended)

  1. In your WordPress admin, go to Plugins → Add New
  2. Search for "WooNutri"
  3. Click Install Now, then Activate

2 Manual Upload

  1. Download the plugin ZIP file
  2. Go to Plugins → Add New → Upload Plugin
  3. Choose the ZIP file and click Install Now
  4. Click Activate
💡 Tip: Make sure WooCommerce is installed and activated before installing WooNutri.

Configuration

After activation, configure WooNutri from WooNutri → Settings in your WordPress admin menu.

Settings Page Layout

The settings page features a two-column layout:

  • Settings Tabs (Left) – Configure options organized into Display, Appearance, and Advanced tabs. Choose from 35+ themes across 3 categories.
  • Live Label Preview (Right) – See real-time changes as you adjust settings. Click any theme to preview it instantly with sample nutrition data.

Display Tab

  • Display Position – Choose Product Summary, Dedicated Tab, or Both
  • Tab Configuration – Customize tab title, priority, and icon
  • Display Format – Per 100g, per serving, or both
  • Nutri-Score Badge – Enable/disable automatic Nutri-Score display
  • UK Traffic Light Indicators – Show color-coded nutrition levels (Pro)

Appearance Tab

  • Label Theme – Choose from 35+ themes organized in 3 categories:
    • Compliance Standards: WooNutri, FDA, EU, UK, Australia, Canada
    • Style Themes: Minimal, Clean, Simple, Compact, Modern, Dark, Premium, Gradient
    • Specialty Themes: Organic, Sport, Kids, Vegan, Keto, Neon
  • Colors – Customize primary, background, text, and border colors
  • Typography – Font family and size options

Advanced Tab

  • Table Layout – Standard, compact, or comfortable spacing
  • Units Configuration – Customize unit display for each nutrient
  • Cache Management – Clear cached labels when needed

Adding Nutrition Data

1 Open the Product Editor

Go to Products → All Products and edit any product.

2 Navigate to the Nutrition Tab

In the Product Data section, click the Nutrition tab.

3 Enter Nutrition Values

Fill in the nutrition information per 100g or per serving:

  • Energy – Enter in kcal (kJ is calculated automatically)
  • Fat, Saturated Fat – In grams
  • Carbohydrates, Sugars – In grams
  • Protein – In grams
  • Salt – In grams

4 Add Allergens (Optional)

Select any allergens present in the product. These will display with warning icons.

5 Save the Product

Click Update to save. The nutrition label will appear on your product page!

💡 Pro Tip: Use the Barcode Lookup feature (Pro) to auto-fill nutrition data from the Open Food Facts database.

Working with Variable Products (Pro)

WooNutri Pro allows you to set different nutrition data for each variation of a product (e.g., different flavors of protein powder).

1 Enable Variations Support

Ensure your product is set to Variable product in the Product Data dropdown.

2 Configure Variations

  1. Go to the Variations tab.
  2. Expand a variation (e.g., "Chocolate Flavor").
  3. Scroll down to the Nutrition Facts section within that variation.
  4. Uncheck "Use Parent Data" to override the main product's nutrition.
  5. Enter the specific values for this variation.
✨ Smart Switching: On the frontend, when a customer selects a variation, the nutrition label will automatically update to show the correct data without reloading the page.

Print-Ready PDF Label Export (Pro)

Generate professional, print-ready PDF labels for your product packaging directly from WordPress admin.

Accessing the Label Export

Go to WooNutri → Label Export in your WordPress admin menu.

Available Label Sizes

Size Name Dimensions Best For
Small 50 × 70 mm Small jars, bottles, sachets
Medium 70 × 100 mm Standard packaging, pouches
Large 100 × 150 mm Boxes, retail packaging
FDA Standard 2.625" × 5" (66.7 × 127 mm) US FDA Nutrition Facts format
FDA Tabular 5" × 2.5" (127 × 63.5 mm) Horizontal FDA format
EU Standard 74 × 105 mm EU 1169/2011 compliant labels
Full Page A4 (210 × 297 mm) Documentation, proofs
Custom Any size Your specific requirements

PDF Templates

📄 Standard Template

Clean, professional layout with clear typography. Suitable for most applications.

🇺🇸 FDA 2020 Template

Bold calorie display, % Daily Value column. Compliant with US FDA 2020 requirements.

🇪🇺 EU Table Template

Per 100g/100ml format with Reference Intake. EU Regulation 1169/2011 compliant.

🇬🇧 UK Traffic Light

Color-coded red/amber/green indicators for fat, saturates, sugar, and salt.

✨ Minimal Template

Clean borders, minimal styling. Perfect for premium/luxury products.

📦 Boxed Template

Structured grid layout with clear sections. Great for detailed nutrition info.

Print Options

  • DPI Settings: Choose 150 DPI (preview), 300 DPI (standard print), or 600 DPI (professional print).
  • Bleed Area: Add 3mm bleed for professional printing (prevents white edges after trimming).
  • Crop Marks: Include registration marks for accurate cutting.

Content Options

  • Product Header: Include product name and image.
  • Allergens: Display allergen warnings with icons.
  • Ingredients: Full ingredients list with allergen bolding.
  • Nutri-Score: A-E rating badge.
  • Barcode Area: Leave space for barcode stickers.
  • Regulatory Text: Include required legal text.

Batch Export

Export multiple products to a single PDF:

  1. Select multiple products using the checkboxes.
  2. Click "Export All Selected".
  3. Each label appears on its own page.

Quick Export from Product List

For quick exports, you can also:

  • Go to Products → All Products.
  • Look for the nutrition column (carrot icon 🥕).
  • Click the PDF icon to instantly export that product's label.
  • Or select multiple products and use Bulk Actions → Export Nutrition Labels (PDF).
🚀 Pro Tip: Use the preview feature to check your label before exporting. Adjust content options until you're satisfied, then export at 300 DPI for professional printing.

UK Traffic Light System

The UK Traffic Light system uses color-coded indicators to help consumers quickly understand the nutritional profile of a product.

How It Works

Each nutrient is assigned a color based on its level per 100g:

Nutrient 🟢 Green (Low) 🟡 Amber (Medium) 🔴 Red (High)
Fat ≤3g 3.1-17.5g >17.5g
Saturated Fat ≤1.5g 1.6-5g >5g
Sugar ≤5g 5.1-22.5g >22.5g
Salt ≤0.3g 0.31-1.5g >1.5g

Enabling Traffic Light Display

  1. Go to WooNutri → Settings in your WordPress admin.
  2. Click the Display tab.
  3. Scroll down to the "Display Features" section.
  4. Enable "UK Traffic Light Indicators".
  5. Save changes.

Once enabled, color-coded indicators will appear on your nutrition labels showing whether fat, saturated fat, sugar, and salt levels are low (green), medium (amber), or high (red).

Live Preview

Use the Live Label Preview panel on the right side of the Settings page to see how your labels look in real-time. Click the "UK" theme button to preview Traffic Light styling with sample nutrition data.

PDF Export with Traffic Light

When exporting PDF labels, select the "UK Traffic Light" template to include color-coded indicators on your printed labels.

💡 Market Insight: UK consumers are familiar with traffic light labeling. Using it can increase trust and help health-conscious shoppers make quick decisions.

REST API (Pro)

WooNutri Pro exposes nutrition data via the WordPress REST API, enabling headless commerce and third-party integrations.

Endpoints

GET /wp-json/woonutri/v1/products/{id}/nutrition

Returns the nutrition data for a specific product.

Example Response:

{ "product_id": 123, "serving_size": "100g", "energy_kcal": 250, "energy_kj": 1046, "fat": 12.5, "saturated_fat": 3.2, "carbs": 30.0, "sugar": 8.5, "fiber": 2.1, "protein": 8.0, "salt": 0.5, "allergens": ["gluten", "milk"], "nutri_score": "B", "traffic_light": { "fat": "amber", "saturated_fat": "amber", "sugar": "amber", "salt": "green" } }

Authentication

The API respects WooCommerce REST API authentication. Use consumer key/secret for authenticated requests.

Use Cases

  • Mobile Apps: Display nutrition info in your store's mobile app.
  • Headless Commerce: Build custom frontends with Next.js, React, etc.
  • Third-Party Integrations: Sync nutrition data with inventory systems.
  • Digital Signage: Display nutrition info on in-store screens.

Analytics & Reports

Track how customers interact with your nutrition labels.

  • Views: See which product labels are viewed most often.
  • Interactions: Track clicks on "Expand" for vitamins or ingredients.
  • Export: Download interaction data for your marketing team.

Go to WooNutri → Analytics to view your dashboard.

Product Comparison Widget

Allow customers to compare the nutritional value of multiple products side-by-side.

Usage

Enable the Comparison Widget in WooNutri → Settings → Comparison. This adds a "Compare Nutrition" button to product pages.

Bulk Editor (Pro)

Save time by editing nutrition data for multiple products at once.

Features

  • Filter Products: Easily find products by category, tag, or keyword.
  • Batch Update: Apply changes to selected fields across many products.
  • Import/Export: Use CSV files to manage nutrition data for your entire catalog.
⚡ Efficiency: Ideal for updating seasonal products or applying a new dietary badge to a large group of items.

Nutri-Score Settings

Customize how Nutri-Score is calculated and displayed on your products.

Configuration Options

  • Enable/Disable: Toggle Nutri-Score calculation globally or per product.
  • Custom Ingredients: Add specific ingredients to influence Nutri-Score (e.g., fruits, vegetables, nuts).
  • Display Position: Choose where the Nutri-Score badge appears on the label.
⚠️ Important: Accurate Nutri-Score calculation relies on correct nutrition data and ingredient classification.

Dietary Preferences

Help customers filter products based on their dietary needs and preferences.

Features

  • Dietary Badges: Display badges for Vegan, Vegetarian, Gluten-Free, Keto, etc.
  • Filter Widgets: Provide frontend filters for customers to easily find suitable products.
  • Customizable: Add your own custom dietary preferences and assign them to products.
📈 Boost Sales: Catering to specific dietary needs can significantly improve customer satisfaction and conversion rates.

Gutenberg Blocks

Embed nutrition labels in any blog post or page using the native Block Editor.

How to Use

  1. Edit any Post or Page.
  2. Click the + button to add a block.
  3. Search for "Nutrition Label".
  4. Select a product to display its label.

This is perfect for writing blog posts about your products (e.g., "Why our protein bar is healthier").

SEO Schema Output

WooNutri automatically injects JSON-LD structured data for nutrition into your product pages.

  • Calories: Automapped to `nutrition.calories`
  • Nutrients: Maps fat, protein, sugar, etc. to Schema.org standards.

Result: Google can display your product's calories and nutrition directly in search results (Rich Snippets).

Use Cases

WooNutri is designed for various food-related products. Here are some common scenarios:

🍞 Food Products

Perfect for bakeries, grocery stores, and food manufacturers selling packaged goods.

  • Display full macronutrient breakdown
  • Highlight allergens (gluten, nuts, dairy, etc.)
  • Use EU or FDA-compliant label themes
  • Add ingredients list with auto-bolded allergens

💊 Supplements & Vitamins

Ideal for supplement stores selling vitamins, minerals, and nutritional products.

  • Display extended vitamin and mineral content
  • Show % of Reference Daily Intake
  • Add serving size information
  • Include dietary badges (Vegan, Gluten-Free)

🥤 Beverages

Great for drink manufacturers, smoothie bars, and beverage retailers.

  • Display per-bottle or per-serving nutrition
  • Highlight sugar content prominently
  • Show energy values in both kcal and kJ
  • Add "Zero Sugar" or other dietary badges

🇪🇺 EU Regulation Compliance

Ensure your labels meet EU Regulation 1169/2011 requirements.

  • Use the EU-compliant theme for proper formatting
  • Display mandatory allergens with proper highlighting
  • Show Nutri-Score for quick health indication
  • Include required "per 100g" nutritional values
⚠️ Note: WooNutri provides tools for compliance, but always verify with local authorities that your labels meet all regulatory requirements.

Shortcodes

Use shortcodes to display nutrition labels anywhere on your site.

Basic Usage

[woonutri_label]

Displays the nutrition label for the current product (use on single product pages).

With Product ID

[woonutri_label id="123"]

Displays the nutrition label for a specific product by ID.

Custom Theme

[woonutri_label theme="modern"]

Override the default theme. Options include: basic, minimal, modern, clean, simple, compact, premium, dark, gradient, fda, eu, uk, australia, canada, organic, sport, kids, vegan, keto, neon, and more (35+ themes available)

Frequently Asked Questions

Download from WordPress.org, upload via Plugins → Add New, or install directly from the WordPress plugin directory by searching for "WooNutri".
Yes, WooNutri includes EU-compliant label themes that follow EU Regulation 1169/2011 for food information to consumers. The plugin provides the tools needed for compliance, but always verify with local authorities.
Yes, with WooNutri Pro you can create multiple nutrition profiles for different product variations. Each variation can have its own nutrition data.
The barcode lookup feature uses the Open Food Facts database, a free and open database of food products from around the world. It contains millions of products with verified nutrition information.
No, WooNutri is optimized for performance. It uses caching, loads styles only on product pages, and has minimal impact on page load times.
WooNutri calculates Nutri-Score based on the official algorithm, considering energy, sugars, saturated fat, sodium (negative points) and fruits/vegetables, fiber, protein (positive points). The score ranges from A (healthiest) to E.

Still Have Questions?

We're here to help you get the most out of WooNutri.

Contact Support Upgrade to Pro