Troubleshooting Guide

Your nutrition labels aren’t working as expected

Nothing is more frustrating than spending time setting up nutrition data only to find it’s not displaying correctly or causing conflicts. This guide helps you diagnose and fix the most common issues quickly.

Quick Diagnostic Checklist

Before diving into specific problems, run through this checklist:

  • [ ] Plugin is activated and up to date
  • [ ] WooCommerce is activated and compatible
  • [ ] Product has “Enable Nutrition Information” checked
  • [ ] At least one nutrition field has a value
  • [ ] Serving size is defined (especially for FDA format)
  • [ ] No PHP errors in debug log

Display Issues

Nutrition Tab Not Appearing

Problem: No nutrition tab shows on product page

Possible Causes & Solutions:

  1. Nutrition not enabled for product
  • Edit the product → Nutrition tab → Check “Enable Nutrition Information”
  1. No nutrition data entered
  • Enter at least one nutrition value (energy, protein, fat, etc.)
  1. Theme conflicts
  • Switch to a default theme temporarily to test
  • Check if theme overrides WooCommerce templates
  1. Plugin conflicts
  • Deactivate other plugins to identify conflicts
  • Common conflicts: custom product tab plugins

Debug Steps:

// Add to functions.php temporarily to debug
add_action( 'wp_footer', function() {
    global $product;
    if ( $product ) {
        $nutrition_enabled = get_post_meta( $product->get_id(), '_nw_nutrition_enabled', true );
        $nutrition_data = get_post_meta( $product->get_id(), '_nw_nutrition_data', true );
        echo "<!-- Nutrition Debug: Enabled={$nutrition_enabled}, Data=" . json_encode($nutrition_data) . " -->";
    }
});Code language: PHP (php)

Empty Nutrition Table

Problem: Tab appears but table is empty or shows “no information available”

Solutions:

  1. Check data format
  • Ensure numeric fields contain numbers, not text
  • Remove any currency symbols or units from input fields
  1. Verify input method
  • If data source is “per 100g”, select “Per 100g” input method
  • If data source is “per serving”, select “Per Serving” input method
  1. Clear caching
  • Clear any site caching (WP Rocket, W3 Total Cache, etc.)
  • Clear browser cache

FDA Format Not Displaying

Problem: Selected FDA format but seeing default table or no table

Root Cause: FDA format requires valid serving size

Solution:

  1. Edit the product
  2. Go to Nutrition tab
  3. Enter both serving size amount AND unit
  4. Ensure amount is greater than 0
  5. Save product

Example:

  • Serving Size Amount: 30
  • Serving Size Unit: g

Values Look Wrong

Problem: Displayed values don’t match your input

Diagnostic Questions:

  1. Are you using FDA format?
  • FDA applies mandatory rounding rules
  • 38.24 calories → 40 calories (rounded to nearest 10)
  • This is correct behavior, not a bug
  1. Input method mismatch?
  • Entered “per 100g” data but selected “per serving” method
  • Or vice versa
  1. Unit conversion confusion?
  • Imperial setting converts g to oz for display
  • Check your display unit setting in WooCommerce → Settings → Nutrition

Fix: Match your input method to your data source, verify display units setting.

Variable Product Issues

Variations Not Showing Different Nutrition

Problem: All variations show same nutrition data

Cause: Variation overrides not enabled

Solution:

  1. Edit the variable product
  2. Go to Variations tab
  3. Expand the variation that should be different
  4. Check “Override product nutrition information for this variation?”
  5. Enter variation-specific data
  6. Save

Data Entry Problems

Rich Text Editor Issues (Ingredients/Allergens)

Problem: Editor not loading or saving rich text content

Solutions: Try changing browsers to se if it works in another, and report your findings to support. We want to keep track and of these issues.

Was this page helpful?