Template parameter types

Every template asks you for a specific set of values, called parameters. Each parameter has a type, and the type decides how it appears in the form and what you are allowed to enter. Knowing the types makes filling in any template — even one you have never seen — straightforward. This page lists every parameter type impressBox templates use, with examples.

Text

A single line (or block) of text. Use it for titles, names, headlines, captions, or any wording.

Example: the Title of a menu board, or a meal name such as "Tomato soup".

A text parameter — here a menu title and a meal name

A text parameter — here a menu title and a meal name


Number

A numeric value. The template may set a default, and sometimes a minimum and maximum. If a value is out of range, impressBox will not accept it.

Examples: a price (e.g. 4.50), a delay in seconds before the next item shows, or a left side width that must be between 1 and 99 percent.

A number parameter — the 2 Columns delays and left-side width

A number parameter — the 2 Columns delays and left-side width


Choice

One value chosen from a fixed set of options, shown as a dropdown or a row of buttons. You can only pick one of the offered options.

Example: an alignment (left / centre / right) or a theme.

On / off

A simple switch — a yes/no or enable/disable value.

Example: show or hide a header, or turn a border on or off.

Date & time

A date (or date-and-time) chosen from a picker.

Example: an event date, or a "valid until" moment.

Colour

A colour, chosen with a colour swatch or by typing a hex code such as #FF0000 (red) or #000000 (black). Use it to set text or background colours where a template exposes them.

Group (object)

A set of related fields kept together under one heading. A group keeps the form tidy when several values belong to the same thing.

Example: the Header group of the Daily lunch template contains the Title field. Expanding the group reveals the fields inside it.

A group parameter — the Header group of the Daily lunch template, with a Title field inside

A group parameter — the Header group of the Daily lunch template, with a Title field inside


List / table (repeatable items)

A parameter that holds many items of the same shape, which you can add to, remove from, and reorder. These usually appear as a small table (one row per item) or as tabs.

Example: the meals list, where each row has a name and a price. Add a row for every dish; delete a row to remove a dish. Because the list is editable as a whole, when you change one row the others stay as they are.

A list/table parameter — the Meals list, with ADD ITEM to add rows

A list/table parameter — the Meals list, with ADD ITEM to add rows


Media file (from your content library)

A field that points to an image or video you have in impressBox. Instead of typing anything, you pick a file (or upload one) and the template uses it. These fields can hold a single file or a list of files that the template cycles through.

Example: the 2 Columns template has a left-side media list and a right-side media list — you choose which images and videos play on each side. A field like this only works once the file actually exists in your library, so upload your media first (see Adding content to your library).

A media parameter — the Two Columns left/right media lists, each with ADD ITEM

A media parameter — the Two Columns left/right media lists, each with ADD ITEM


A note on labels

The name you see next to a field is its display label, set by whoever built the template. Two templates may show similar fields with different labels — focus on what the field is for (text, number, file, list…) rather than the exact wording. Template builders can rename these labels at any time (see Building and editing templates).

Where to go next