> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voxo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Button Layouts

> This guide provides step-by-step instructions for accessing, adding, editing, duplicating, and deleting button layouts in the Omnia Admin Portal.

## This guide provides step-by-step instructions for accessing, adding, editing, duplicating, and deleting button layouts in the Omnia Admin Portal. Button layouts configure programmable keys on VoIP phones for functions like speed dialing, parking calls, or monitoring extensions.

<Warning>
  This document applies to the following user roles within Omnia:

  Account Administrator
  Partner Administrator
</Warning>

### Accessing Button Layouts

1. **Navigate to Button Layouts**:
   Go to the [Admin Portal](https://app.voxo.co/dashboard) and sign in.
   Click the **Phone System** tab to expand it, then select **Button Layouts**.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-17/ae814caa-f2f4-47a2-8f1f-ddc2882ede01/stack_animation.webp)

### Adding a New Button Layout

2. **Add a New Button Layout:**

* Click **Add New**.
* Enter a name for the button layout in the **Name** field.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-03/32424cae-f249-4e46-8292-f0e99cf08138/stack_animation.webp)

3. **Set the Key Range:**

* Enter the **Start Key** number. This is the first button you want to configure.
* Enter the **End Key** number. This should be greater than the start key number, covering all buttons you want to configure.

## ![](https://colony-recorder.s3.amazonaws.com/files/2024-06-03/99d5e081-5206-4833-aed5-f3ddb00cab32/stack_animation.webp)

<Tip>
  #### Notes:

  The End Key must be greater than the Start Key to create a valid range for button configuration.

  The Key type field is required for Yealink devices. Ensure this field is filled to avoid configuration errors.
</Tip>

### Key Assignments

4. **Assign Functions to Keys:**

* **Type**:
  * Click on the dropdown menu to select the function for the key. Options include:
    * **BLF (Busy Lamp Field)**: Monitors the status of another extension (busy or available).
    * **Park**: Allows you to park a call on a specific number.
    * **Speed Dial**: Provides quick dialing of a predefined number.
    * **BLF (Grandstream)**: Specific to Grandstream devices, similar to BLF.
    * **Speed Dial (Grandstream)**: Speed dial for Grandstream devices.
    * **Park (Grandstream)**: Park call for Grandstream devices.
* **Name**:
  * Enter a descriptive name for the key (e.g., "Park 1" or "Voicemail").
* **Number**:
  * Select or enter the number associated with the function. This could be an extension number, a park slot number, or a speed dial number.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-04/4682fd18-4099-42b4-9d8b-59685b35d699/stack_animation.webp)

5. **Repeat for Additional Keys:**

* Continue assigning **Types**, **Names**, and **Numbers** for each key within the range specified.

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-06-03/9429430b-f8da-43d3-b27b-1f0f02d1a3f1/ascreenshot.jpeg?tl_px=322,278\&br_px=1182,759\&force_format=jpeg\&q=100\&width=860\&wat_scale=76\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/F43F5E_standard.png\&wat_pad=402,212)

6. **Save Changes:**

* After configuring all necessary keys, review your entries to ensure accuracy.
* Click **Create** then **Yes** to apply the changes.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-03/ba491b4c-4d82-46c5-b42d-f11aa438a9bd/stack_animation.webp)

<Tip>
  Saved changes should auto-populate on the assigned phones. If the new buttons don't appear, reboot the phone by unplugging it for 15 seconds and plugging it back in.

  To pick up a held call from a different phone, use **Park** slots rather than regular Hold. A call placed in a park slot can be retrieved from any phone that has a Park button assigned to that same slot — regular Hold keeps the call on the original phone only.
</Tip>

### Duplicating a Button Layout

7. **Duplicate layout:**

* Click the **Duplicate** button next to a button layout to duplicate.
* Click **Yes** to confirm the duplication.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-03/07844d3c-9d14-44fb-bb6e-1e5a8bd1cea3/stack_animation.webp)

### Editing a Button Layout

8. **Edit Layout:**

* Click on the button layout you want to edit or click the **Edit** button next to it.
* Make your edits
* Click **Edit**, then **Yes** to confirm and save your changes.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-03/16db2c3b-a014-454b-88bd-1285ef7d679a/stack_animation.webp)

### Deleting a Button Layout

9. **Delete Layout:**

* Click the **Delete** button next to the Button Layout.
* Confirm the deletion by clicking **Yes**.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-03/7473bbf6-72a1-46a6-8502-6f99d2b31c47/stack_animation.webp)

### Search and Sort

10. **Search Button Layouts:**

* **Search Bar**: Quickly find specific items by typing the name or a keyword in the search field. The system will filter the list based on your search input, displaying the relevant results.
* **Sort**: Click the sort icons next to column headers to arrange items in ascending or descending order.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-15/82b3db82-c817-410b-be0f-9f3e95e234e8/stack_animation.webp)

### Rolling out a layout to multiple phones

There is no one-click bulk edit — button layouts are assigned per device, so each phone gets its layout individually. To roll a layout out to many phones, build it once (or **Duplicate** an existing layout as a starting point), then assign it to each device. Saved changes should auto-populate on the assigned phones; reboot only the phones that don't pick up the change by unplugging them for about 15 seconds and plugging them back in.