> For the complete documentation index, see [llms.txt](https://docs.foodcore.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.foodcore.io/labels/create-label.md).

# Generate your first label

{% hint style="warning" %}
FoodCore helps you organise and manage the information you need, but you should always check official guidance or speak to your local authority if unsure.
{% endhint %}

Creating a label in FoodCore takes about five minutes once your recipes and allergens are set up. Everything is visual — you drag blocks onto a canvas, arrange them, and preview the result before you export. Here's how to do it from start to finish.

## Before You Start

Make sure the recipe you're labelling has its allergens set correctly. The label designer pulls allergen data directly from your recipes, which in turn get it from your ingredients. If allergens are missing on any ingredient, the label won't be able to declare them. Run the **allergen audit** if you're unsure.

Also check that your **Business Details** are filled in under Settings — your business name and address are used on the label automatically.

## Step 1: Create a New Label

**Go to** **Labels** in the main navigation.

**Click** **+ New Label**.

You'll be prompted to give the label a name (e.g. "Lemon Drizzle 80×50") and to enter your label dimensions. **Enter** the width and height in millimetres — these should match your actual label stock or the size you intend to print.

**Choose** a shape: **Rectangle**, **Circle**, or **Rounded Rectangle**. Most labels are rectangular, but circular labels work well for jar lids and some premium packaging.

## Step 2: Link a Recipe

**Click** **Link Recipe** and search for the recipe this label is for. Once you select it, FoodCore automatically pulls in:

* The ingredient list
* Allergen data for all 14 declarable allergens
* Nutritional information (if you've entered it on the recipe)
* Storage instructions (if set on the recipe)

This connection is live — if you update the recipe later and recompute it, those changes are reflected on this label.

## Step 3: Add Blocks from the Palette

The left-hand panel is your block palette. **Drag** blocks onto the canvas to add them to your label. The blocks you'll typically want for a PPDS-compliant label are:

* **Product Name** — drag this on first and position it prominently at the top
* **Allergen Statement** — this is the PPDS-compliant block. It generates a full ingredient list with the 14 declarable allergens automatically **bolded**. Use this instead of the plain Ingredients block for Natasha's Law compliance.
* **Nutrition Table** — choose whether to display per 100g, per serving, or per batch
* **Use By Date** or **Best Before Date** — you fill in the actual date at print time
* **Storage Instructions** — describes how to store and handle the product
* **Batch Code** — for traceability; enter at print time
* **Net Weight / Volume** — the declared weight or volume of the product
* **Business Name & Address** — pulled automatically from Settings → Business Details

Optional blocks include **Logo / Image**, **Custom Text**, and **QR Code**.

## Step 4: Arrange Your Layout

**Click** any block on the canvas to select it. You can then:

* **Drag** it to reposition it
* **Drag the corner handles** to resize it
* **Edit styles** in the right-hand panel — font family, font size, text colour, background colour, border, padding

Take your time here. The canvas is an exact preview of how your label will look when printed. What you see is what you get.

## Step 5: Preview the Label

**Click** **Preview** (or the eye icon) to open a full-size preview of the label. This shows the label at its actual printed dimensions. Check that:

* All text is readable at the intended print size
* The allergen statement is legible
* Nothing is cut off at the edges
* The layout looks balanced

If anything needs adjusting, **close** the preview and make your changes on the canvas.

## Step 6: Export or Print

When you're happy with the label, **click** **Export**. Your options are:

* **Print / Save as PDF** — opens the browser print dialog. Select your printer or choose "Save as PDF". The label is sized precisely to your specified dimensions.
* **PNG** — exports a high-resolution image at \~288 dpi
* **JPG** — same as PNG, slightly smaller file
* **+ Print Queue** — adds the label to the print queue for a connected thermal printer

For most bakeries and small food producers, **PDF** is the most versatile option — it prints correctly on any printer and can be sent to a commercial printer if needed.

## Tips

* The **Allergen Statement** block automatically bolds all 14 declarable allergens within the ingredient list. You don't need to format this manually.
* If your label has a **Use By Date** or **Batch Code**, these are entered fresh each time you print — you don't need to create a new label design for every batch.
* Save your label design so you can reuse it. Next time you need to print a batch, just open the saved design, update the date and batch code, and print.

## What's Next

* [Natasha's Law & PPDS compliance](https://docs.foodcore.io/labels/natashas-law.md)
* [Export options explained](https://docs.foodcore.io/labels/export.md)
* [All available label blocks](https://docs.foodcore.io/labels/blocks.md)
