Skip to content
Docs
Voxbi Cockpit APIs
API Guides

Layout

A status changer layout is a per-target button arrangement for the status-changer widget on terminals, in the Voxbi app, and on the web. Each layout maps a set of statuses to buttons so different devices and departments see only the statuses relevant to them.

Overview

Layouts decouple what statuses exist (managed on the statuses page) from what a given device shows.

What it does

When someone opens the status changer, the client reports its source (terminal, app, or web) and its target (the employee or terminal). The system picks the most specific layout matching both, and falls back to the default when nothing matches.

The layout editor: a grid size picker beside the arrangement of status buttons
The layout editor: a grid size picker beside the arrangement of status buttons

The grid size sets how many columns and rows of buttons the target sees, and the editor beside it is what the employee will actually be looking at.

See also

Form fields

Fields available in the create and edit forms.

General

Name

Descriptive label for this layout, shown in dropdowns and on the terminals configuration page.

Sources

Which client apps show this layout. Select one or more of Voxbi Web, Voxbi Mobile, Badge Reader, and Tempus Native.

Is default

When on, this layout is the fallback for users with no specific layout assigned. Every tenant needs exactly one default.

Is active

When off, this layout is hidden from all users and devices.

All targets

When on, the layout applies to every terminal, user, and group. Turn off to target specific groups or devices below.

Shown when

Is default is off

Targets

Specific terminals, departments, employees, or Cockpit groups that see this layout. Editable only when All targets is off.

Shown when

Is default is off

Updated