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

# Add elements

> Text, image, QR, and rectangle elements with the full property panels for each.

The template editor has four element types: **Text**, **Image**, **QR**, and **Rect**. You add them from the **Add element** row in the left sidebar, drag and resize them on the canvas, and configure their properties in the right panel.

> [!NOTE]
>
> **Before you start**
>
> * A template open in the [editor](https://docs.eventsbadge.com/templates/editor-overview.md).
> * For text elements bound to attendee fields: an event that has at least one imported attendee, so you can preview the binding with **Preview as**.

## Add an element

**1. Add the element**

In the left sidebar, click **T (Text)**, **Image**, **QR**, or **Rect**. The element drops at the canvas center at a default size.

**2. Position and resize**

Drag it into place and resize from the corner handles.

**3. Configure in the right panel**

Fine-tune position and content from the right property panel.

![Template editor with the name text selected on the canvas and its position, content, typography and layout fields in the right panel](https://mintcdn.com/eventsbadge/sVLPHidr7TFp4nzL/images/screens/template-editor-element.png?fit=max\&auto=format\&n=sVLPHidr7TFp4nzL\&q=85\&s=737aab0392ac4e74b7da1126e62b0d07)

A text element selected, with its properties on the right

## Text

Text elements display a string. The string can be **Custom** (literal text), **Attendee** (a bound field that resolves per attendee at print time), or **Question** (the attendee's answer to one of the event's registration questions).

**Position.** `X`, `Y`, `W`, `H` in millimeters. Editing `H` divides by `Max lines` to keep the font size legible.

**Content.** Pick a **Data type**:

* **Custom.** Fixed text you type in the **Text** input. Use for static labels like an event title or sponsor name.
* **Question.** Bind to one of the event's registration questions. Pick the question in the panel and the attendee's answer prints in its place. Use for dietary tags, track selection, or T-shirt size. The list comes from the event's provider, or, on an event you created in Badge, from the CSV columns you kept as custom fields. Nothing prints until you pick a question. In the preview, an unanswered question shows its label faded; that label never prints, so the spot stays empty for an attendee who skipped the question.
* **Attendee.** Bind to one of these fields, which resolve per attendee at print time:

  | Field | What it contains |
  | - | - |
  | Full name | Attendee's combined first + last name |
  | First name | Attendee's first name |
  | Last name | Attendee's last name |
  | Company | Attendee's company |
  | Job title | Attendee's job title |
  | Email | Attendee's email address |
  | Phone | Attendee's phone number |
  | Ticket name | The ticket type the attendee bought |
  | Barcode | The attendee's barcode (same value the QR can encode) |

**Typography.** **Font size** in mm (1–50), **Align** (Left / Center / Right), and **Vertical align** (Top / Middle / Bottom) for where the text sits inside its box. Text in non-Latin scripts, such as a Chinese, Japanese, or Korean name, prints as it appears on the canvas.

**Layout.** **Max lines** (1 or 2; controls how text wraps inside the box), **Case** transform (None / Upper / Lower / Title), **Autoscale** to shrink long values automatically so they fit. Autoscale stops at 3 mm, the smallest size that stays readable on a 203 dpi print. When the preview attendee's value still doesn't fit at that size, the panel warns you to widen the box or shorten the text; otherwise it shows the size autoscale picks for that value.

**Style.** **Invert** flips the element to white-on-black for printing on dark backgrounds.

## Image

Image elements display a static image, typically a logo or sponsor mark.

**Position.** `X`, `Y`, `W`, `H` in millimeters.

**Image.** Drop a file in the **Source** dropzone or click **Browse**. PNG and JPEG are supported; max file size is 4.5 MB. The image is embedded directly in the template.

**Monochrome threshold.** Zebra label printers are monochrome, so color and grayscale images are converted to black-and-white at print time. The threshold slider (0–255) sets which pixels become black: lower values keep less detail, higher values keep more. The canvas shows the image after this conversion, so adjust the slider until it looks the way you want it printed.

## QR

QR elements render a square barcode that staff or attendees can scan.

**Position.** `X`, `Y` in millimeters and a single `Size` (mm) that controls both width and height since the QR is square.

**QR content.** Pick a **QR type**:

* **Barcode** encodes the attendee's barcode. Staff check-in and booth [lead capture](https://docs.eventsbadge.com/events/lead-capture.md) both read this value to look up the attendee, so use it for the QR that staff scan. Any other type shows a warning in the panel: `Check-in and booth scanning read the attendee barcode. This QR won't work for them.`
* **URL** encodes a fixed URL that you enter in the **URL** field below. Use for a sponsor link, a Wi-Fi captive page, or a session schedule. Nothing prints until you enter a URL.
* **Contact (vCard)** encodes the attendee's name, company, job title, email, and phone as a vCard, so anyone who scans the badge saves the contact straight to their phone.

The right panel includes a live preview that updates as you change the type and URL.

## Rect

Rect elements draw a rectangle, useful for ticket-type color bars, dividers, or framing a section of the badge.

**Position.** `X`, `Y`, `W`, `H` in millimeters.

**Style**:

* **Filled.** Solid fill (toggle on for a color bar; off for an outline).
* **Border (mm).** Outline thickness when **Filled** is off, or the inner border when **Filled** is on. Step is 0.1 mm.

## Edit and reorder

The **Elements** list in the left sidebar lists every element in stacking order. Drag to reorder, click to select. Selected elements show their properties in the right panel. Delete with Delete or Backspace. Undo and Redo (⌘Z / ⇧⌘Z) cover every drag, resize, and field edit.

## Related

* [Editor overview](https://docs.eventsbadge.com/templates/editor-overview.md). Sidebar layout, canvas controls, save and discard.
* [Printer settings](https://docs.eventsbadge.com/templates/printer-settings.md). Label size presets and per-printer calibration.
* [Connect a printer](https://docs.eventsbadge.com/printer-setup/webusb-connection.md). Pair a Zebra printer to test prints.
* [Events, attendees, templates](https://docs.eventsbadge.com/concepts/events-attendees-templates.md). What attendee fields exist for text bindings.


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