Reference

Label Designer

The built-in template editor: element types, placeholder tokens, and template slots per size and mode.

Last updated 2026-05-23 · Applies to NotBot 1.3.4+

The Label Designer is a built-in template editor that lets you customize how labels look. It opens from the Label Designer tab in the top bar of the app, or from the Customize in Labels designer → link in Settings → Print Settings (the link uses lowercase "designer", but it opens the same Label Designer).

Templates per size and per mode

Each label size has three template slots, one per print mode:

  • Item template: used when printing item labels (Every Item mode for all events; Buyer Only mode default-mode events; Every Item + Buyer mode item labels).
  • Buyer template: used when printing buyer/box labels. This covers Buyer Only mode auctions, Buyer Only mode giveaways or Buy It Now sales when their label mode is Buyer label only or Buyer + item labels, and Every Item + Buyer mode buyer labels (whenever Print box label for new buyers is on, whether the label is the first one for a new buyer or a milestone reprint). Also used for the buyer-label half of bonus and reprint milestones in all the same cases.
  • Both template: used in Every Item + Buyer mode for item labels, which include the buyer's number alongside the item name.

NotBot ships with 15 built-in templates: five sizes by three modes (item, buyer, both). Built-in templates cannot be modified directly, but you can duplicate one and customize the copy.

A common pitfall: when you create a custom template for Every Item + Buyer mode, the template's print-mode field must be set to Both. Setting it to Item makes NotBot fall back to the built-in template and ignore your custom design. This is the most common reason a custom template appears to be ignored in that mode.

The four element types

Elements are dropped onto the canvas and positioned proportionally so designs scale across label sizes.

Text

Static text or a placeholder token (see below). Properties:

  • Content: literal text or a token like {username}.
  • Font size, font weight (Normal or Bold), color, alignment (left, center, or right).
  • Auto Fit: shrinks the text to fit the element's bounds when content is too long.
  • Word Wrap: wraps text to multiple lines within the element.

Image

A logo from the logo library. The image scales to fill the element's bounding box.

  • Upload PNG or JPEG images.
  • Maximum file size 5 MB per logo.
  • Logos are stored locally on your computer. They do not leave the device.

Line

A line element that can be rotated.

  • Stroke color, stroke width.

Rectangle

A box with configurable border and fill.

  • Border color, border width.
  • Fill color (can be transparent).

Placeholder tokens

Tokens are dynamic text that NotBot replaces at print time with the real values from the event. The token picker in the designer only shows tokens that apply to the current template's print mode.

Token Available in template modes What it shows
{number} Buyer, Both The buyer's assigned number for this show. Blank if no number has been assigned to this event.
{username} Buyer, Item, Both The buyer's platform username.
{itemName} Item, Both The item name as published by the platform.
{badge} Item, Both The event badge: AUCTION WIN, BUY IT NOW, GIVEAWAY, BONUS, or PENDING PAYMENT.
{auctionNumber} Item, Both The sequential auction number in this show. This is NotBot's own count, not the platform's.
{purchaseCount} Item, Buyer, Both For regular and reprint labels, the buyer's combined auction and Buy It Now count. For bonus labels, the count that triggered the milestone.
{quantity} Item, Both The units sold for a Buy It Now or flash sale. Renders blank on auction and giveaway labels.
{price} Item, Both The sale price, formatted as $XX.XX.

A token rendered against an event that has no value for it (for example, {quantity} on an auction label) renders blank. No error, just empty.

Canvas and editing

  • Drag: click and drag any element to reposition.
  • Resize: select an element and drag the bottom-right resize handle.
  • Delete: select an element and press Delete or Backspace.
  • Properties panel: select an element and the right panel shows every editable property.
  • Deselect: click empty canvas space.
  • Undo/Redo: up to 50 levels.
  • Orientation: toggle between landscape and portrait per template.

Preview mode (in the Designer)

Click Preview to see the rendered template filled with sample data, such as {username} showing as "TestUser123" and {number} showing as 42. The canvas background turns light green and editing is disabled while previewing. Click the preview banner to exit.

This preview shows you what the template looks like. It does not test the print path end to end. For that, use Settings → Print Settings → Print Test Label.

Linking templates to print modes

Templates are linked per label size and per print mode, not per show. The active template for each size/mode pair is stored in your settings. When you switch print mode mid-show, NotBot automatically uses the active template for the new mode without any reconfiguration.

See also