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

# My label looks wrong

Most label issues come down to one of a handful of root causes: dimensions that don't match your label stock, allergen data that hasn't been set on an ingredient, or recipe data that's gone stale and needs recomputing. Work through the issues below to find and fix the problem.

## 1. Content Is Being Cut Off

**Symptom:** Part of the label — text, a block, or a section — is missing or clipped when you export or print.

**Check your label dimensions.** Open the label settings and confirm that the width and height you've set match the physical label stock you're printing on. If your label stock is 75 mm wide but you've set the label to 100 mm wide, content will be cut off when printed.

Measure your label stock and update the dimensions to match. The canvas will resize and you can re-arrange your blocks to fit the correct area.

If you're saving as PDF, also check the **Scale** setting in the browser print dialog — make sure it's set to **100%** or **"Actual size"**, not "Fit to printable area". Chrome doesn't show a Margins option when printing a PDF (that only appears for web pages), so Scale is the setting to check.

## 2. Allergens Are Missing from the Label

**Symptom:** The Allergen Statement block is incomplete — one or more allergens you know are present aren't appearing, or the ingredient list looks shorter than expected.

**Check that allergens are set on every ingredient in the recipe.** The Allergen Statement block generates content from your recipe's ingredient allergen data. If any ingredient hasn't had its allergens set, FoodCore can't declare those allergens on the label.

**Go to** **Allergens → Audit** and run the audit for the recipe in question. If any ingredients are flagged as missing allergen data, **click** through to that ingredient, **set** the correct allergen status on the Allergens tab, and **save**. Then regenerate or refresh your label.

If you've recently added a new ingredient to a recipe, make sure you've set its allergens before using it on a label.

## 3. The Recipe Data on the Label Is Wrong

**Symptom:** The ingredient list, allergen data, or nutritional values on the label don't match what you expect based on the current recipe.

**Recompute the recipe.** Recipe costs and computed values (including nutritional summaries) aren't always recalculated automatically when you change an ingredient. **Open** the recipe, **click** **Recompute** (or the equivalent recalculate button), and **save** the recipe. Then re-open your label — the linked recipe data will refresh.

This is especially important after:

* Changing an ingredient's allergen status
* Updating an ingredient's cost, weight, or nutritional values
* Adding or removing ingredients from the recipe

## 4. PNG or JPG Quality Is Too Low for Print

**Symptom:** The exported PNG or JPG looks pixelated or blurry when printed.

**Use PDF instead of PNG/JPG for print.** FoodCore exports PNG and JPG at approximately 288 dpi (3× screen resolution), which is fine for digital use and on-screen viewing but may not meet the quality requirements of commercial printing. If you're sending a label to a print shop or printing at a large size, use the **Print / Save as PDF** option instead — PDF is resolution-independent and will always print at the full quality your printer can deliver.

If you specifically need a high-resolution image file (for example, for product photography composites), discuss requirements with your printer — they may accept PDF directly.

## 5. Business Address Is Missing from the Label

**Symptom:** The Business Name & Address block is blank or shows placeholder text.

**Fill in your business details in Settings.** The Business Name & Address block pulls information from **Settings → Business Details**. If that section hasn't been completed, the block has nothing to display.

**Go to** **Settings → Business Details**, **enter** your business name, address, and any other contact information you want on your labels, and **save**. Return to your label design — the block will now display the correct information.

## 6. My Label Text Went Tiny

**Symptom:** Text or blocks that looked a normal size while you were designing shrink down small once you preview or print.

**This is working as designed — it's FoodCore protecting you from cut-off content.** Label size is set **only** in the toolbar (the **Size** preset, or the width/height fields in mm). **Margin** sets a physical inset from the edge of the label (0mm = edge to edge).

If the blocks you've placed add up to more content — taller or wider — than the label can physically hold, FoodCore **shrinks the whole layout to fit** rather than cutting anything off. While you're editing, the status bar tells you this is about to happen: **"Overflows — will shrink to NN% when printed"**. The dashed line on the canvas marks the actual label edge, so you can see at a glance how much you're over.

**Fix:** either **reduce the content** (smaller fonts, shorter text, fewer blocks) so it fits at 100%, or **increase the label size** in the toolbar to match how much you're trying to fit on it. Watch the status bar as you edit — once it stops saying "Overflows", nothing on the label will be shrunk at print time.

## 7. A Sheet of Labels Prints Shifted or Off the Die-Cut

**Symptom:** Printing a full sheet (Avery or custom grid) via **Print Sheet**, labels drift away from the sticker cell — usually worse the further out from the centre of the sheet.

**Check your browser's print Scale setting first.** Chrome's PDF viewer usually defaults to **"Fit to printable area"**, which scales the whole sheet down by roughly 4% and re-centres it — shifting every label slightly toward the middle. **Set Scale to 100%** (or **"Actual size"**) in the print dialog before printing.

{% hint style="warning" %}
Chrome shows **no Margins option** when printing a PDF (that setting only appears for web pages, not PDF files) — don't look for a "Margins: None" option here. **Scale** is the setting that matters.
{% endhint %}

If Scale is already at 100% and stickers still land off the die-cut, see [Printing a sheet of labels](https://docs.foodcore.io/labels/print-sheet.md) for the **Print alignment test**, which tells you whether it's a scaling problem or a margin problem before you commit a full sheet of stickers.

## 8. The Label Preview Looks Correct but Printing Is Wrong

**Symptom:** The on-screen preview looks exactly right, but the printed output has shifted content, incorrect scaling, or unexpected margins.

**Check your browser print settings.** When the browser print dialog opens, make sure:

* **Destination** is set to the correct printer
* **Scale** is set to **100%** or **"Actual size"** — do not use "Fit to printable area"
* **Paper size** matches what's loaded in your printer (or that you're printing on label stock, not A4)

Note that Chrome doesn't show a Margins option for PDF printing (only for web pages) — Scale is the setting that matters here.

Different browsers handle print dialogs slightly differently. If you're having consistent trouble, try a different browser — Chrome and Edge generally produce the most reliable results for label printing.

## What's Next

* [Generate your first label](https://docs.foodcore.io/labels/create-label.md)
* [Printing a sheet of labels](https://docs.foodcore.io/labels/print-sheet.md)
* [Add allergens to ingredients](https://docs.foodcore.io/allergens/add-allergens.md)
* [Update your business details](https://docs.foodcore.io/settings/business-details.md)
