# Button Layouts

# Overview

The **Button Layouts** page defines reusable phone button ranges, layout templates, and phone-book button behavior. Open it from **Configuration > Provisioning > Button Layouts**.

The page works against the tenant currently selected in the top bar. The screenshots and demo rows were captured in the **Canistracci OIL** tenant.

<figure id="bkmrk-button-layouts-list-">![Button Layouts list page in the Canistracci OIL tenant.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/lNEbutton-layouts-list.png)<figcaption>Button Layouts list page in the Canistracci OIL tenant.</figcaption></figure>## Working with objects

<table id="bkmrk-taskhow-to-do-it-add"><thead><tr><th>Task</th><th>How to do it</th></tr></thead><tbody><tr><td>Add</td><td>Select the New button layout action, complete the form, and select Save.</td></tr><tr><td>Edit</td><td>Open the button layout from the list by selecting its name, number, or row action. Change the form and select Save.</td></tr><tr><td>Delete</td><td>Select the row checkbox and use Delete Selected, or open the button layout and select Delete, then confirm.</td></tr></tbody></table>

## Page functions

<table id="bkmrk-actiondescription-ne"><thead><tr><th>Action</th><th>Description</th></tr></thead><tbody><tr><td>New Button Layout</td><td>Opens the creation form for a new button layout.</td></tr><tr><td>Delete Selected</td><td>Deletes the selected rows after confirmation.</td></tr></tbody></table>

## List columns

<table id="bkmrk-columndescription-na"><thead><tr><th>Column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Display name used in lists and references.</td></tr><tr><td>Template</td><td>Object setting shown by the form.</td></tr><tr><td>Code</td><td>Dialed value, identifier, or matching value used by the PBX.</td></tr><tr><td>Start</td><td>Object setting shown by the form.</td></tr><tr><td>End</td><td>Object setting shown by the form.</td></tr><tr><td>Actions</td><td>Object setting shown by the form.</td></tr></tbody></table>

## Demo records

The tenant contains 2 documentation demo records for this page: Docs Demo Buttons 1 and Docs Demo Buttons 2.

## Deleting records

Before deleting a button layout, check references from call flows, destinations, schedules, reports, or provisioning objects. MiRTA PBX asks for confirmation before the delete is submitted.

# Create and Edit Button Layouts

Use this page when creating a new button layout or editing an existing button layout from **Configuration &gt; Button Layouts**.

The form screenshots below are separated by block where the application exposes separate sections. Complete the required values, review routing or destination references, and save the record.

## Add and edit form

<figure id="bkmrk-button-layouts-add%2Fe">![Button Layouts add/edit form.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/azlbutton-layouts-form.png)<figcaption>Button Layouts add/edit form.</figcaption></figure>## Main fields

<table id="bkmrk-fielddescription-nam"><thead><tr><th>Field</th><th>Description</th></tr></thead><tbody><tr><td>Name:</td><td>Display name used in lists and references.</td></tr><tr><td>Button Layout Template:</td><td>Object setting shown by the form.</td></tr><tr><td>Code:</td><td>Dialed value, identifier, or matching value used by the PBX.</td></tr><tr><td>usephonebook</td><td>Object setting shown by the form.</td></tr><tr><td>Phone Book:</td><td>Object setting shown by the form.</td></tr><tr><td>Start:</td><td>Object setting shown by the form.</td></tr><tr><td>End:</td><td>Object setting shown by the form.</td></tr></tbody></table>

## Saving and deleting

<table id="bkmrk-taskhow-to-do-it-cre"><thead><tr><th>Task</th><th>How to do it</th></tr></thead><tbody><tr><td>Create</td><td>Select the new action from the Button Layouts list, fill the required fields, and select Save.</td></tr><tr><td>Edit</td><td>Open the existing button layout, update the needed fields, and select Save.</td></tr><tr><td>Delete</td><td>Before deleting a button layout, check call-flow, destination, schedule, report, provisioning, or integration references. Use the row delete action or the form delete action when available, then confirm.</td></tr></tbody></table>