> 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/blocks.md).

# Blocks & layout

The label designer works by combining individual blocks — each one represents a piece of information — into a finished label layout. You choose which blocks you need, drag them onto the canvas, position and resize them, and style them to match your brand.

Here's a complete reference for every block type available.

## Adding Blocks

**Drag** any block from the left-hand palette onto the canvas. You can add as many instances of most blocks as you need — for example, two Custom Text blocks if you want two separate text fields with different styling.

To **remove** a block, **select** it on the canvas and press **Delete** (or use the remove button in the right-hand panel).

## Resizing and Positioning

Once a block is on the canvas:

* **Drag** the block to move it anywhere on the label
* **Drag the corner or edge handles** to resize it
* Use the **right-hand panel** to enter precise pixel or millimetre values for position, width, and height if you need exact placement

## Styling Blocks

**Select** any block on the canvas to open its style options in the right-hand panel. Options vary by block type but generally include:

* **Font family** — choose from available web-safe fonts
* **Font size** — in points
* **Text colour** — colour picker or hex value
* **Background colour** — for the block's fill
* **Border** — toggle on/off, set width and colour
* **Padding** — internal spacing between the text and the block edge
* **Text alignment** — left, centre, right

## Block Reference

### Product Name

Displays the name of the linked recipe as the product name on your label. The text is editable so you can override it for display purposes (e.g. "Lemon Drizzle Cake" instead of your internal recipe code name).

Style this block prominently — it's usually the largest text on the label.

### Ingredients

Displays the full ingredient list from the linked recipe, listed in descending order by weight. This is a plain ingredient list with no allergen emphasis.

Use the **Allergen Statement** block instead if you need PPDS-compliant allergen formatting.

### Allergen Statement (PPDS-Compliant)

This is the core compliance block. It generates a complete ingredient list from the linked recipe with all 14 declarable allergens automatically **bolded** within the text. It also adds a separate "May contain:" line if any ingredients carry a May Contain allergen status.

Use this block on any label for food you sell prepacked-for-direct-sale. It satisfies the Natasha's Law requirement for allergen emphasis within the ingredient list without any manual formatting on your part.

### Nutrition Table

Displays a formatted nutrition table. You can choose to show values **per 100g**, **per serving**, or **per batch** — or display multiple columns side by side.

The data is pulled from your recipe's nutritional information. If you haven't entered nutritional values for the recipe, this block will be empty.

The table uses a fixed-column layout with clearly delineated rows for: Energy (kJ/kcal), Fat, of which Saturates, Carbohydrate, of which Sugars, Fibre, Protein, and Salt.

### Use By Date

A date field that displays a "Use by:" declaration. The date is entered at print time (not at design time), so you can reuse the same label design for every batch. The "Use by" phrasing is used for perishable food where safety depends on the date.

### Best Before Date

Similar to Use By Date but uses "Best before:" phrasing — appropriate for shelf-stable products where quality rather than safety is the concern.

### Storage Instructions

Free text describing how the product should be stored and handled. For example: "Keep refrigerated. Once opened, consume within 2 days." You can type this directly on the block or pull it from your recipe defaults.

### Batch Code

A batch or lot number field entered at print time. Essential for traceability — if you ever need to recall a product or investigate a customer complaint, the batch code tells you exactly which production run was involved.

### Net Weight / Volume

Declares the net weight in grams (g or kg) or net volume in millilitres (ml or L). This is a legal requirement on most pre-packed food. Enter the value for the specific pack size you're labelling.

### Business Name & Address

Displays your business name, address, and contact details. FoodCore pulls this automatically from **Settings → Business Details**. If the block appears empty, check that your business details are filled in under Settings.

### Logo / Image

Upload your brand logo or any other image to include on the label. Supports PNG (recommended for logos with transparency) and JPG. For best results, upload at 300 dpi or higher.

### Custom Text

A free-text block for anything that doesn't fit another block type. Use it for:

* Website or social media handles
* Certification marks (e.g. "Certified Gluten Free", "Suitable for Vegans")
* Care instructions
* Marketing copy

### QR Code

Generates a QR code that links to a URL you specify. Useful for linking customers to your website, an allergen information page, or an online menu.

## Building a PPDS-Compliant Label Layout

For a label that meets Natasha's Law requirements, make sure you include at minimum:

1. **Product Name** block
2. **Allergen Statement** block (not the plain Ingredients block)

Everything else — nutrition table, dates, weight, address — is best practice or required under broader pre-packed food regulations, but the name and allergen-emphasised ingredient list are the core PPDS requirements.

## What's Next

* [Generate your first label](https://docs.foodcore.io/labels/create-label.md)
* [Export options: PDF, PNG, JPG, print queue](https://docs.foodcore.io/labels/export.md)
