> ## Documentation Index
> Fetch the complete documentation index at: https://docs.luxima.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Design a label

> Create a label design and lay it out in the designer.

**Label design** in the menu lists your label designs as cards. Each card shows a preview, the design's status, its size, and which print stations use it.

![The Label design page with two design cards. The first is marked Company default and is printed by all other stations. The second is marked Active and linked to one print station, with a Set as company default button.](https://mintcdn.com/mbp-network-technology-limited/iXJRiuzZUPUSyyJh/images/printing/label-designs.png?fit=max\&auto=format\&n=iXJRiuzZUPUSyyJh\&q=85\&s=7e96be889815216ef91ed1b09a14a97e)

Two label designs: the company default, and a design linked to one station

The preview on a card uses sample product values, so you can see how the label fills in.

> [!NOTE]
>
> Owners, Admins and Editors can create and change designs. Other roles see them as view only.

## Create a design

**1. Start**

Click **New label design**.

**2. Name it**

Give the design a name, for example "Sew-in textile tag".

**3. Choose a size**

| Preset | Size |
| - | - |
| **Sew-in textile tag** | 40 × 80 mm |
| **Sticker** | 50 × 25 mm |
| **Hang tag** | 60 × 90 mm |
| **Carton label** | 100 × 50 mm |
| **Custom size** | Any size from 10 to 300 mm |

You can change the size later in the designer.

**4. Choose the sides**

* **Folded in half:** a two-sided label that folds across the middle, such as a sew-in tag. The top half is the front and the bottom half is the back.
* **One-sided:** printed on one side only.

**5. Open the designer**

Click **Create and open designer**.

## The designer

* **Left, Elements:** everything you can put on the label. Drag a tile onto the label, or click it. Tiles you have already used show a tick.
* **Middle, the canvas:** your label with rulers in millimetres. A folded label shows **Front** and **Back**.
* **Right, Properties:** settings for the element you selected, or for the label itself when nothing is selected.

Use −, + and **Fit** to zoom. **Snap to grid 1 mm** keeps elements lined up; click it to switch it off.

## Elements

| Group | Elements |
| - | - |
| **Product information** | Product name, SKU, Size, Colour, GTIN number, Brand name, Product code, Category, HS code |
| **Textile information** | Composition, Care symbols, Country of origin, Washing instructions |
| **Traceability** | DPP QR code, Barcode, Passport link, Passport ID |
| **Design elements** | Text, Image, Line / Divider, Box |

Product, textile and traceability elements are filled in from each product when you print. Design elements are the same on every label.

A label can hold up to 50 elements.

### Move, resize and rotate

Select an element to see its handles. Drag it to move it, drag a handle to resize it, and use the rotate handle to turn it. For exact values, type **X**, **Y**, **Width**, **Height** and **Rotation** in Properties.

| Keys | Action |
| - | - |
| Arrow keys | Move 1 mm. With Shift, 5 mm. |
| Delete | Remove the element. |
| Cmd/Ctrl + D | Duplicate it. |
| Cmd/Ctrl + Z | Undo. |
| Cmd/Ctrl + Shift + Z | Redo. |
| Esc | Deselect. |

### Settings by element

> [accordion] Product and textile fields
>
> * **Font size**, **Weight** (Regular or Bold) and **Align**.
> * **Show caption** and **Caption:** a small title above the value, such as "Size".
> * **Uppercase** and **Border**.
> * **Hide when empty:** leaves the field off the label when a product has no value for it.
> * **Fallback text:** what to print when a product has no value, for example "ONE SIZE".

> [accordion] DPP QR code
>
> The QR code holds the passport link for the size being printed.
>
> * **Error correction:** M, Q or H. Higher levels survive more damage but need a larger code.
> * **Quiet zone:** the empty margin around the code.
>
> Keep the code large enough to scan. The designer warns you when it is too small.

> [accordion] Barcode
>
> Prints an EAN-13 barcode from the size's GTIN. Tick **Show digits under the bars** to print the number too.
>
> A size with only a non-standard barcode prints it as Code 128. A size with neither prints without a barcode.

> [accordion] Care symbols
>
> Prints the product's care symbols. Set the **Symbol size** and the **Gap** between symbols.

> [accordion] Text
>
> Fixed text of up to 500 characters, with font size, weight and alignment.

> [accordion] Image
>
> Click **Upload image**, or drop an image file onto the canvas. Use PNG, JPEG or WebP, up to 10 MB. The image is scaled to fit its box.
>
> Use this for your logo.

> [accordion] Line and Box
>
> A line has a **Thickness**. A box has a **Border thickness** and can be **Filled**.

## Label settings

Click an empty part of the canvas to see the label's own settings:

* **Preset**, **Width** and **Height**
* **Orientation:** portrait or landscape
* **Safe margin:** the edge area to keep clear, from 0 to 20 mm
* **Sides:** One-sided or Folded in half
* **Print resolution:** 203, 300 or 600 dpi. Match your printer.

## Preview

Switch **Mode** from **Design** to **Preview** to see the label on a sample garment, as a **Neck label** and a **Side seam** label, true to scale. A folded label also shows the **Back of label**.

To see it with real data, use **Preview with product** at the bottom of Properties. Search for a product and choose a size.

Under the preview you see either "Prints as shown" or a list of notes for that product. Click a note to jump to the element.

## Print a test label

Click **Print test label** in the toolbar to open the label as a PDF and print it on your own printer.

## Saving

The designer saves your work automatically a moment after each change. The toolbar shows **Saved** or **Unsaved changes**.

Saving does not send the label to your stations. For that, see [Activate and assign labels](https://docs.luxima.io/printing/activate-and-assign.md).

## Warnings

| Message | What to do |
| - | - |
| "... sits outside the printable area" | Move the element inside the safe margin. |
| "The text does not fit its box and was cut short" | Make the box bigger or the font smaller. |
| "This product has no value for ..." | Add the data to the product, or set a fallback text. |
| "QR modules are ... mm; make the code larger so scanners can read it" | Enlarge the QR code. |
| "The QR code box is smaller than its quiet zone" | Enlarge the box or reduce the quiet zone. |
| "No GTIN yet - the label prints without a barcode" | Add a GTIN to the size. |
| "This product has no care data yet" | Choose a care preset on the product. |
| "Upload an image for this element" | Upload an image, or remove the element. |
| "A label can hold at most 50 elements" | Remove some elements. |

## Duplicate or delete a design

On a design's card:

* **Duplicate** copies it into a new design and opens the designer.
* The bin icon deletes the design and all its versions. This cannot be undone. The company default cannot be deleted; make another design the default first.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.