# 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.