Reference

Label Designer

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

Last updated 2026-06-05 · Applies to NotBot 1.3.6+

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, OFFER ACCEPTED, 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.
`{date}`	Item, Buyer, Both	The date the label was queued for printing. Format is configured per-label in the Date format dropdown. For real-time prints this is effectively the sale time. Reprinting an item from history creates a fresh label and stamps a new date; only retries of a failed queue job preserve the original date.
`{time}`	Item, Buyer, Both	The time the label was queued for printing. Format is configured per-label in the Time format dropdown. Same fresh-stamp-on-history-reprint behavior as `{date}`.
`{dateTime}`	Item, Buyer, Both	A combined date and time. Both Date format and Time format dropdowns apply.

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.

Date and time formatting

When a {date}, {time}, or {dateTime} token is on the label, the properties panel for that element shows two extra dropdowns. They are per-label settings, so different templates can show different formats.

Date format options (the dropdown option text matches what gets printed):

Mar 26
03/26/2026
26/03/2026
2026-03-26
March 26, 2026

Time format options:

2:30 PM
14:30
Hide time — renders an empty string, useful on a {dateTime} token when you want the date but not the time.

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 → Test Print.

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.