Generating Health Star Ratings


This article will help you get started with Health Star Ratings (HSR) in Nutrition Labelling. Health Star Ratings are a voluntary front-of-pack labelling system that rate the nutritional profile of food products. This article is also available as a video tutorial, click to play below. 

Video Tutorial

Youtube banners (23).png

Set up your workspace to calculate HSRs

Nutrition Labelling workspaces with the country set to Australia, will have HSRs enabled by default. These workspaces are ready to calculate HSRs. If you are working in an Australian workspace, you can skip to Set up your raw materials

Nutrition Labelling workspaces with the country set to New Zealand, will have HSRs disabled by default.

To set up the workspace to calculate HSRs: 

  1. On the sidebar, select  Settings and select the Nutrients & components tab.
  2. Select the Health Star Rating (HSR) category. 
  3. Enable all nutrients within that category, including: Health Star Rating (HSR), FVNL - Fruit, Vegetables, Nuts, Legumes and Concentrated FV - Fruits & Vegetables.

To show HSRs on the label: 

  1. Open your sub-recipe or recipe resource.
  2. Select the Labelling tab and select the HSR tab.
  3. Toggle on Show HSR on label.

Set up your raw materials 

For each raw material you need to provide values for both % FVNL and % Concentrated FV. For definitions and how to determine FVNL and Concentrated FV for your ingredients, see Step 5 of Section 4 in the Guide for Industry.

Foodworks will use these components to calculate the V points for your recipes. There are two ways for you to set these values for raw materials:

  • Open each individual raw material and set the values in the Nutrients & Components tab.


  • Use the FVNL Editor to set the values for all your raw materials at once. Both ways are described below.


  • If an ingredient has a mix of FVNL and concentrated FV, Foodworks automatically calculates the total V points.
  • You do not need to provide points for protein (P points) and fibre (F points). Foodworks calculates these values automatically and applies them to the baseline points as required.

To set the HSR components for an individual raw material:

  1. In Foodworks, open the raw material.
  2. Click the Nutrients & Components tab.
  3. In the Override column, enter a value for the % FVNL and % Concentrated FV for this ingredient.
  4. Select Save.

Optional - Use the HSR bulk editor

To make it easier to enter or edit HSR components for your raw materials in bulk, the FVNL Editor shows all the raw materials in your database in one table.

To use the FVNL Editor:

  1. On the sidebar, select Bulk Edit and select the FVNL tab. In the FVNL editor, all your raw materials are listed in alphabetical order.
  2. Enter the values for FVNL and CFV as required. 



You can use keyboard shortcuts to make it quicker to enter the percentage FVNL and CFV. Type a for 100% and z for 0%.

Finalising the HSR for a recipe

Foodworks calculates the HSR for your recipe from its raw materials and from the HSR category to which you assign the recipe. 

To set the HSR category for the recipe:

  1. In Foodworks, open the recipe.
  2. On the General tab, select the appropriate category from the HSR/NPSC Category dropdown.


For definitions and how to determine the HSR category for your recipes, see Steps 1 and 2 of Section 4 in the Guide for Industry.


There are three categories that receive an automatic HSR including Plain water, Unsweetened flavoured water and Fresh and minimally processed fruits and vegetables. Additionally, there are six other HSR categories described in the Guide. These are the same categories used for nutrient profile scoring as described in the Food Standards Code.  
  • Category 1 - Non-dairy beverages, jellies and water-based ice confections (excluding Category 1D beverages).
  • Category 1D - Milk (defined in Standard 2.5.1 of the Code) and dairy beverages (including dairy alternative beverages) that meet specified dairy criteria.
  • Category 2 - All foods (other than those included in Category 1, 1D, 2D, 3 or 3D).
  • Category 2D - Dairy foods (other than those included in Category 1D or 3D) with ≥75% dairy or permitted dairy alternative content.
  • Category 3 - Oils and spreads, defined as follows:
    • 1.1.1. Edible oil as defined in Standard 2.4.1 of the Code.
    • 1.1.2. Edible oil spreads as defined in Standard 2.4.2 of the Code.
    • 1.1.3. Margarine as defined in Standard 2.4.2 of the Code.
    • 1.1.4. Butter as defined in Standard 2.5.5 of the Code.
  • Category 3D - Cheese (including surface ripened cheese) and processed cheese as defined in Standard 2.5.4 of the Code (with calcium content 320 mg/100 g).

Check the nutrients used to calculate HSRs

In your open recipe, you can see the calculated value for the HSR, in both the analysis pane and the label viewer. 


To check that the necessary nutrients for HSRs are all calculating correctly:

  1. In the analysis pane, for the following nutrients/components check that there are no question marks ? or uncertain values (values displaying in yellow), and that the value appears reasonable:
    • FVNL
    • Concentrated FV
    • Energy
    • Protein
    • Saturated Fat
    • Sugars
    • Fibre
    • Sodium
  2. If there are question marks or uncertain values for these nutrients, investigate and resolve the issues. 

To investigate issues within the recipes composition:

  1. In the analysis pane, select the nutrient with the missing value.
  2. Click the Ingredients tab of the recipe. Look at the nutrient-focus column to check for missing values for any of the ingredients.
  3. Select    Ellipsis to open the nested resource to make any necessary changes to the ingredients.

Displaying the HSR on a label

When displaying the HSR on your label, Foodworks provides several standard designs for the HSR system graphic that you can choose from.

For guidance on the principles of the HSR system and the details of its presentation on food packages, see the Style Guide.

To show the HSR graphic on a label:

  1. In the open recipe, select Label on the analysis pane.
  2. Select the Labelling tab, then select the HSR tab.
  3. Toggle on Show HSR on label.

Your label will now display with the HSR graphic. 

To edit the style of the HSR graphic:

  1. From the HSR dropdown, select which version of the graphic you wish to display from the following options:
    • HSR only
    • HSR + Energy
    • HSR + Energy + 3 prescribed nutrients
  2. Select the HSR mark orientation from the following options: 
    • Landscape
    • Portrait (Left)
    • Portrait (Right)


You may also check the box next to QR code to also display a quick response code on the label. Companies are encouraged to display a Health Star Rating QR code that directs consumers the Health Star Rating website when scanned.

Printing the label

Now that you have your label ready, here are the options for printing or publishing your label. 

Copy to clipboard

On the label viewer, select the  Copy HSR button to copy your HSR graphic to your clipboard. Once copied, you can paste the image outside the app where needed. 

Generate PNG

Alternatively, you can save your entire label as a PNG. On the label viewer, simply select  Generate PNG. The label will download automatically. 


Publishing your HSR information

You can publish the labelling information for all your recipes from your Foodworks workspace to a .csv file, ready for use by your label printing software.

To publish the labelling information from your workspace: 

  1. Open the Foodworks workspace.
  2. On the sidebar, select    Tools and then select the Publish labelling information tab.
  3. Use the Resources and tags to fine tune which resources you wish to publish.
  4. Select Publish
  5. Once generated, select Download. This download link will be valid for 10 minutes.


You may also wish to send the labelling information .csv to another device. To do so, select  Copy link to clipboard and paste to send the link to download the labelling information .csv, please note the download link will be valid for 10 minutes.

HSR information published

When you publish your labelling data, Foodworks includes information to support HSR.

The HSR columns published are as follows:

  • HSRStars – number of stars in numeric value.
  • HSRStyle – numeric value from 0 to 4.
    • 0 = No HSR
    • 1 = HSR only
    • 2 = HSR + Energy
    • 4 = HSR + Energy + 3 Nutrients
  • HSRImage – This value corresponds to the Health Star Rating image name in the HSR Assets folder. The steps to download the HSR assets are detailed below. 
  • HSRUnits – numeric value from 0 to 2.
    • 0 = per 100g
    • 1 = per 100ml
    • 2 = per pack
  • HSRUnitsStatement – ‘per 100g’, ‘per 100ml’ or 'per pack' in text.
  • HSREnergy – energy value and unit in text.
  • HSRSaturatedFat – saturated fat value and unit in text.
  • HSRSugars – sugars value and unit in text.
  • HSRSodium – sodium value and unit in text.

Download the HSR assets

If your labelling software requires the raw images of the HSR graphics, you can download the asset folder from 

To download the HSR assets: 

  1. Open a Foodworks Nutriton Labelling workspace.
  2. On the sidebar, select Tools and then select the Assets tab.
  3. Select to download all HSR graphics. 
  4. Select the downloaded to unzip the assets and use the PNGs. 
Was this article helpful?
3 out of 3 found this helpful



Please sign in to leave a comment.