Generating Health Star Ratings

This article will help you get started with Health Star Ratings (HSR) in Foodworks.online 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

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. 

To set up the workspace to calculate HSRs: 

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

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.

To set the HSR components for an individual raw material:

1. In Foodworks, open the raw material.
2. Click the Nutrients tab.
3. In the Override column, enter a value for the % FVNL and % Concentrated FV for this ingredient.
4. Changes are saved automatically.

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.

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 calculated correctly:

1. In the analysis pane, for the following nutrients/components check that there are no question marks ? or uncertain values (values displayed 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 recipe 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 be displayed with the HSR graphic. 

To edit the style of the HSR graphic:

1. 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

Printing the label

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

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. 

Exporting your HSR information

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

To export the label data from your workspace: 

1. Open the Foodworks workspace.
2. On the sidebar, select    Tools and then select the Export tab.
3. Use the Resources and tags to fine-tune which resources you wish to export.
4. Select Export. 
5. Once generated, your .csv will be available to download on the Files sub-tab. 

HSR label data

When you export label data, Foodworks includes information to support HSR.

The HSR columns exported 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 Foodworks.online. 

To download the HSR assets: 

1. Open a Foodworks Nutrition Labelling workspace.
2. On the sidebar, select Tools and then select the Assets sub-tab on the Files tab.
3. Select HealthStarRatings_assets to download all HSR graphics. 
4. Select the downloaded HSRAssets.zip to unzip the assets and use the PNGs.