---
title: "Layouts"
canonical: "https://docs.cuesystem.com/space/SSG/295895086/Layouts"
format: markdown
---
## Overview

A layout describes the design and functionality of the control panel. The Simple Setup can use max. 5 keypads. All keypads can have the same layout (that means all keypads have the same functionality) or each keypad may have a different layout (that means different functionality). Finally, for each unique keypad, you need to prepare a dedicated layout.

In default, every Simple Setup project contains one layout named “Default keypad”. For the basic system with one keypad, this layout is enough and it is not necessary to create another one.

To prepare a customized keypad layout, follow these steps:

1. Define default values for backlight brightness and for indicator brightness.
2. Edit every button to create a label, select the button type and connect pre-prepared macro(s) to the button.
3. Create a button label PDF to print keypad labels.

## Basic interface

The basic layout interface looks like this:

![image](media://4c45e762-4919-4b47-a433-b696c9834ada)

## Adding a new layout

Use the **New** button to create new layout. A pop-up window is displayed.

![image](media://fbd42d19-b937-42b9-a6af-b40ddfd38bc0)

Follow these steps:

1. Fill in the layout name. This name must be unique among the layouts.
2. Setdefaultbacklight brightnessand defaultindicatorbrightness. Thesevalues willbe usedwhenthe controllerstarts.
3. Press **Save** to store the new layout.

The new layout is added to the layout list and contains default buttons.

## Deleting a layout

Use the **Delete** button to delete a layout. A pop-up window is displayed. Confirm the action by the **Delete **button.

![image](media://da6c9705-18b7-4641-b53f-d7ad0c83fe18)

## Editing a layout

Use the **Update** button to edit the selected layout. a pop-up window is displayed and you can edit all layout properties.

![image](media://86817cda-5299-40db-b676-f6f5d1bb19d8)

## Editing a button

Click the **Edit** button located in the button list to edit a keypad button. A pop-up window is displayed.

![image](media://6233fde4-f63b-4e0b-87c5-0087f5ec68f3)

Follow these steps to edit a keypad button:

1. Every button label can contain a caption, an icon or combination of both. An empty caption as well as an empty icon are permitted. If both are empty, the button has no label (typical for unused keypad buttons).
2. Fill the button caption.
  - If a caption is not filled, it is not used on the label.
  - If an icon is not used, the caption can contain two lines.
  - The character for a new line is \n and can be added using the **Add new line** button.
  - The maximum width of text is automatically checked during input.
3. Select an icon.
  - Select a group of icons and then select a specific icon. Most frequently used icons are available in the “AV control” group.
  - The icon can be used alone or in combination with a caption.
  - Icon positioning is created automatically during the generation of a label file (described below).
4. Select the button type.
  - **Push** - a normal button, e.g. for input selection. When pressed, the connected macro starts.
  - **Repeat** - when pressed, the button starts macro repeatedly. For the repeat button, enter the repeat interval in seconds.
  - **Toggle 2 states** - every button press starts a different macro. Macros 1 and 2 are started and then macro 1 starts again.
  - **Toggle 3 states** - every button press starts a different macro. Macros 1, 2 and 3 are started and then macro 1 starts again.
  - **Toggle 4 states** - every button press starts a different macro. Macros 1, 2, 3 and 4 are started and then macro 1 starts again.
5. Select pre-prepared macro(s) with respect to the selected button type.
  - One macro for Push and Repeat type.
  - Two macros for Toggle 2 states type.
  - Three macros for Toggle 3 states type.
  - Four macros for Toggle 4 states type.
6. Press **Save** to store changes.

## Creating a label

Use the **New label** button to create and download a file containing keypad labels and save it as a ***.pdf** file. This file can be printed using a standard printer. Cut labels can then be installed to the keypad.

The following pop-up window is displayed.

![image](media://3b080497-b81e-418c-9cfc-60d595c3f080)

Select the number of keypad labels on the page (from 1 to 16) and press **Download**. The file will be stored in your downloads folder. The filename, e.g. **SimpleSetup-Boardroom-Default_keypad-2019_07_15-00_27.pdf **consists of Project name_Layout name_Export date and time and an extension pdf.

If you need more than 16 labels (you have more keypads with the same layout), print more copies of the document. Carefully follow the instructions explaining how to print a downloaded file:

- Page size - A4 portrait mode
- Page sizing - set to Actual Size. It prints the page without scaling. Don’t select any scale or other choices.

An example of a label file (16 labels on the page):

![image](media://2df01412-4e0a-40e5-8802-1b4661b7c1bc)