> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytalkvalue.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](/badge/templates/editor-overview).
  * 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**.
</Note>

## Add an element

<Steps>
  <Step title="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.
  </Step>

  <Step title="Position and resize">
    Drag it into place and resize from the corner handles.
  </Step>

  <Step title="Configure in the right panel">
    Fine-tune position and content from the right property panel.
  </Step>
</Steps>

## Text

Text elements display a string. The string can be **Custom** (literal text) or **Attendee** (a bound field that resolves per attendee at print time).

**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.
* **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             |
  | Ticket ID   | The provider's external ticket ID               |
  | Barcode     | Provider barcode (same value the QR can encode) |

**Typography.** **Font size** in mm (1–50) and **Align** (Left / Center / Right).

**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.

**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. Adjust until the preview matches what you want 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**:

* **Ticket ID** encodes the provider's external ticket identifier per attendee.
* **Barcode** encodes the provider's barcode value per attendee (this is what the Badge staff scanner reads to look up an attendee).
* **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.

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](/badge/templates/editor-overview). Sidebar layout, canvas controls, save and discard.
* [Printer settings](/badge/templates/printer-settings). Label size presets and per-printer calibration.
* [Connect a printer](/badge/printer-setup/webusb-connection). Pair a Zebra printer to test prints.
* [Events, attendees, templates](/badge/concepts/events-attendees-templates). What attendee fields exist for text bindings.
