---
title: 'Status changer layouts'
summary: 'A per-target button configuration for the status-changer widget on terminals, in the Voxbi app, and on the web. Different rooms / departments can each have their own button arrangement.'
section: features
tags:
  - crud
  - tempus
  - hardware
  - status
updated: '2026-08-12'
---

> A **status changer layout** is a per-target button arrangement for the status-changer widget on [terminals](../tempus/terminals.md), in the Voxbi app, and on the web. Each layout maps a set of [statuses](tempus_statuses.md) to buttons so different devices and departments see only the statuses relevant to them.

## Overview

Layouts decouple *what statuses exist* (managed on the [statuses](tempus_statuses.md) 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](tempus_layouts-images/button-grid.png)

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.

> [!IMPORTANT]
> Keep exactly one default layout. Without one, users with no specific layout see an empty status changer. More specific layouts win, so watch for overlaps that silently hide a layout from some users.

## See also

- [Statuses](tempus_statuses.md) - the buttons a layout arranges.
- [Terminals](../tempus/terminals.md) - the hardware that uses layouts.
- [Tempus schedules](../tempus/tempus_schedules.md) - a related concept that also restricts statuses.

```yaml fields
name:
  label: Name
  tab: General
  hint: 'Descriptive label for this layout, shown in dropdowns and on the terminals configuration page.'
sources:
  label: Sources
  tab: General
  hint: 'Which client apps show this layout. Select one or more of Voxbi Web, Voxbi Mobile, Badge Reader, and Tempus Native.'
is_default:
  label: 'Is default'
  tab: General
  hint: 'When on, this layout is the fallback for users with no specific layout assigned. Every tenant needs exactly one default.'
is_active:
  label: 'Is active'
  tab: General
  hint: 'When off, this layout is hidden from all users and devices.'
all_targets:
  label: 'All targets'
  tab: General
  when: 'Is default is off'
  hint: 'When on, the layout applies to every terminal, user, and group. Turn off to target specific groups or devices below.'
targets:
  label: Targets
  tab: General
  when: 'Is default is off'
  hint: 'Specific terminals, departments, employees, or Cockpit groups that see this layout. Editable only when All targets is off.'
```