# Extensions

# Overview

The **Extensions** page is the tenant-level list for creating, finding, editing, importing, exporting, and deleting extensions. Open it from **Configuration** > **Extensions**.

The page works against the tenant currently selected in the top bar. The screenshots show ten fake demo extensions, numbered **100** through **109**, with a mix of chan\_sip, PJSIP, custom, and virtual extension types. SIP and PJSIP usernames use the extension number followed by the tenant code, for example `100-CANISTRACCI`. Password values are masked in the screenshots.

## Display modes

The Extensions page can be shown in DataTable mode or jqGrid mode. Use the display mode toggle in the toolbar to switch between them.

### DataTable mode

<figure id="bkmrk-extensions-page-in-d">![Extensions page in DataTable display mode with demo extensions 100-109.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/extensions-datatable.png)<figcaption>Extensions page in DataTable display mode with demo extensions 100-109.</figcaption></figure>DataTable mode shows the standard table with search, page-size selection, sorting, row checkboxes, and action buttons above the table.

### jqGrid mode

<figure id="bkmrk-extensions-page-in-j">![Extensions page in jqGrid display mode with demo extensions 100-109.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/extensions-jqgrid.png)<figcaption>Extensions page in jqGrid display mode with demo extensions 100-109.</figcaption></figure>jqGrid mode shows the same extension records in the advanced grid with column filters and grid toolbar actions.

## Toolbar actions

<figure id="bkmrk-extensions-toolbar-w">![Extensions toolbar with creation, display mode, and upload controls.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/2RFextensions-toolbar.png)<figcaption>Extensions toolbar with creation, display mode, and upload controls.</figcaption></figure><table id="bkmrk-actiondescription-ne"> <thead><tr><th>Action</th><th>Description</th></tr></thead> <tbody> <tr><td>New SIP peer / New PJSIP peer</td><td>Creates a standard phone extension. The visible label follows the tenant's preferred SIP stack.</td></tr> <tr><td>Bulk SIP peers</td><td>Opens the bulk creation workflow for adding multiple SIP extensions at once.</td></tr> <tr><td>Custom Extension</td><td>Creates an extension that routes to a custom dial string or custom endpoint logic.</td></tr> <tr><td>Virtual Extension</td><td>Creates a virtual extension that can group or reference other extension destinations.</td></tr> <tr><td>Change to chan\_sip</td><td>Converts selected PJSIP extensions to chan\_sip when the administrator has permission to switch phone technology.</td></tr> <tr><td>Change to PJSIP</td><td>Converts selected chan\_sip extensions to PJSIP when the administrator has permission to switch phone technology.</td></tr> <tr><td>Delete Selected</td><td>Deletes the selected extensions after a confirmation prompt. This action is shown only when delete permission is available.</td></tr> <tr><td>Display mode toggle</td><td>Switches the page between the standard DataTable and jqGrid display modes.</td></tr> <tr><td>CSV/XLS Upload</td><td>Opens the import page for uploading extension records from a CSV or XLS file.</td></tr> </tbody></table>

## Extension table

<figure id="bkmrk-extensions-grid-show">![Extensions grid showing mixed SIP, PJSIP, custom, and virtual extensions.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/t8Gextensions-table.png)<figcaption>Extensions grid showing mixed SIP, PJSIP, custom, and virtual extensions.</figcaption></figure>Use the table controls to filter, sort, select columns, export data, and move between pages. The checkbox column selects rows for bulk actions.

<table id="bkmrk-columndescription-nu"> <thead><tr><th>Column</th><th>Description</th></tr></thead> <tbody> <tr><td>Number</td><td>Extension number. When extension status is enabled, an icon indicates registration or device state.</td></tr> <tr><td>Name</td><td>Extension display name. Icons can indicate call blocking/filtering, DND, unconditional forwarding, or PIN lock.</td></tr> <tr><td>Description</td><td>Free-form extension description. Icons can identify PJSIP, custom, virtual, or recording-related behavior.</td></tr> <tr><td>Tech</td><td>Extension technology. SIP entries are chan\_sip peers, PJSIP entries are PJSIP endpoints, CUSTOM entries route to custom dial strings, and VIRTUAL entries group other extensions.</td></tr> <tr><td>Username</td><td>SIP/PJSIP username used by the phone or endpoint. The default pattern is `<extension number>-<tenant code>`. Clipboard, SRTP, and TLS indicators can appear for phone extensions.</td></tr> <tr><td>Password</td><td>Endpoint secret when password display is enabled. Depending on settings, the value can be hidden or revealed with an eye icon.</td></tr> <tr><td>Action</td><td>Contains quick actions such as showing the extension call flow. Fast provisioning QR code access can also appear when enabled.</td></tr> </tbody></table>

## Editing extensions

Select the extension number, name, description, username, or password cell to open the extension edit form. In jqGrid mode, select a row and use the grid edit action; the grid opens the same edit form.

## jqGrid mode

The display mode toggle can enable jqGrid for the Extensions page. In jqGrid mode, the same extension records are loaded dynamically, and the grid adds toolbar actions for edit, delete, search, column selection, CSV export, and showing the selected extension flow.

## Permissions and limits

Some buttons are hidden when the user lacks permission or when the tenant has reached its extension limit. The page also respects user extension restrictions, so administrators may see only the extensions assigned to their profile.

# Create and Edit chan_sip Extensions

Use this page to create or edit a phone extension that registers as a chan\_sip peer. The form works against the tenant currently selected in the top bar.

The screenshots use the **Canistracci Oil** demo extension **100 Alex Reed**. Creating and editing use the same form: a new extension opens with tenant defaults, while an existing extension opens with saved values.

## Creating and editing

<table id="bkmrk-actiondescriptioncre"><thead><tr><th>Action</th><th>Description</th></tr></thead><tbody><tr><td>Create</td><td>Open Configuration &gt; Extensions and select New SIP peer. Fill the required fields and select Save.</td></tr><tr><td>Edit</td><td>Open an existing extension from the Extensions list. Update the required fields and select Save.</td></tr><tr><td>Delete</td><td>When delete permission is available, open the extension and select Delete. Confirm only after checking routing, phones, queues, and other references.</td></tr></tbody></table>

For chan\_sip extensions, the endpoint username normally uses the extension number, a hyphen, and the tenant code, such as 100-CANISTRACCI. Press the swapped-arrow icon beside Username to switch the separator from a hyphen to an underscore, for example 100\_CANISTRACCI. If custom usernames are enabled in Admin &gt; Settings, you can enter a username that does not follow the generated tenant-code pattern.

## Information

<figure id="bkmrk-information-section-">![Information section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/1iIchan-sip-information.png)<figcaption>Information section for chan\_sip extension 100.</figcaption></figure>Use this section for the extension identity, endpoint credentials, media basics, groups, voicemail message-waiting indication, DND state, and inbound ring timeout.

<table id="bkmrk-blockpurposenumber-a"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Number and name</td><td>Number is the internal extension number. Name is the display name used in lists, caller ID, and reports.</td></tr><tr><td>Description and emergency notes</td><td>Description is an administrator note. Emergency notes can be used by emergency routing and notification logic.</td></tr><tr><td>SIP stack</td><td>Shows whether the endpoint is using chan\_sip or PJSIP. Users with switch permission can change the stack from this form or from the Extensions list.</td></tr><tr><td>Username and password</td><td>Endpoint credentials used by the phone or softphone. The default username pattern is the extension number followed by the tenant code.</td></tr><tr><td>Codecs and DTMF</td><td>Controls the allowed audio/video codecs and DTMF signaling mode used by the endpoint.</td></tr><tr><td>Media and groups</td><td>Direct media, call groups, pickup groups, spy groups, and message-waiting options control how the endpoint participates in calls and monitoring.</td></tr><tr><td>Voicemail, DND, and timeout</td><td>Voicemail MWI, DND, and inbound dial timeout control how incoming calls are presented and how long the extension rings.</td></tr></tbody></table>

### Trunk mode

<figure id="bkmrk-additional-trunk-mod">![Additional trunk mode options visible after enabling Trunk on a chan_sip extension.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/chan-sip-trunk-mode-options.png)<figcaption>Additional trunk mode options visible after enabling Trunk on a chan\_sip extension.</figcaption></figure>Enable **Trunk** only when the chan\_sip peer is another PBX, gateway, or upstream device that should receive calls by dialed number rather than as a single telephone endpoint. A normal phone extension should usually leave this option disabled.

<table id="bkmrk-field-or-optioneffec"><thead><tr><th>Field or option</th><th>Effect</th></tr></thead><tbody><tr><td>Trunk</td><td>Changes how calls are sent to the peer. With trunk mode disabled, MiRTA PBX dials the peer username. With trunk mode enabled, MiRTA PBX dials the called number at that peer, or the configured DID override when one is set.</td></tr><tr><td>DID Number</td><td>Automatic sends the original called number to the peer. Set to sends the value entered in the DID number field instead, which is useful when the downstream PBX or gateway expects a fixed pilot number or a rewritten DID.</td></tr><tr><td>CallerID Number Override</td><td>Controls which outbound caller ID values are preserved from the SIP INVITE received from the trunk device. The default behavior can keep both caller ID name and number from the INVITE. The other choices keep only the number, keep only the name, or ignore the INVITE caller ID and use the caller ID configured on the extension.</td></tr><tr><td>Emergency CallerID Number Override</td><td>For emergency routes, Get Emergency CallerID from SIP Invite allows the emergency caller ID sent by the trunk device to pass through. Do not use Emergency CallerID from SIP Invite makes MiRTA PBX replace it with the extension emergency caller ID, or the tenant default emergency caller ID when the extension does not define one.</td></tr><tr><td>CallerID Number Source</td><td>Selects where inbound trunk caller ID is read from when a specific source is required. Automatic keeps the caller ID parsed by Asterisk. The explicit choices read the From, P-Asserted-Identity, P-Preferred-Identity, or Remote-Party-ID header and use it to set caller ID before routing.</td></tr></tbody></table>

In the dialplan, trunk mode also affects direct calls to this extension. If the peer is registered on the current server or has a static host, the call is built as a trunk-style dial to the peer using the dialed number. If the peer is registered on another node, MiRTA PBX sends the call through the configured inter-node SIP trunking module.

## NAT Control

<figure id="bkmrk-nat-control-section-">![NAT Control section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/ofgchan-sip-nat-control.png)<figcaption>NAT Control section for chan\_sip extension 100.</figcaption></figure>Use this section to control endpoint reachability and keepalive behavior for devices behind NAT or with changing network paths.

<table id="bkmrk-blockpurposenatdefin"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>NAT</td><td>Defines how MiRTA PBX treats NAT traversal for the endpoint.</td></tr><tr><td>Qualify and qualify frequency</td><td>Controls whether the PBX checks endpoint reachability and how often checks are sent.</td></tr><tr><td>Keep alive and RTP keep alive</td><td>Sends periodic traffic to keep network mappings open and detect unavailable devices.</td></tr></tbody></table>

## Call Settings

<figure id="bkmrk-call-settings-sectio">![Call Settings section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/xKzchan-sip-call-settings.png)<figcaption>Call Settings section for chan\_sip extension 100.</figcaption></figure>Use this section for call behavior that is not specific to inbound or outbound routing.

<table id="bkmrk-blockpurposefax-and-"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Fax and volume</td><td>Controls T.38 fax behavior and transmit/receive volume adjustments.</td></tr><tr><td>Music on hold and language</td><td>Selects media behavior and the preferred language for prompts played to the extension.</td></tr><tr><td>Directories and phone books</td><td>Controls whether the extension appears in dial-by-name directories and phone book generated lists.</td></tr><tr><td>Call waiting and autoanswer</td><td>Controls second-call handling and optional automatic answer behavior for supported phones.</td></tr></tbody></table>

## Inbound Recording

<figure id="bkmrk-inbound-recording-se">![Inbound Recording section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/XTuchan-sip-inbound-recording.png)<figcaption>Inbound Recording section for chan\_sip extension 100.</figcaption></figure>Use this section for recording behavior applied to calls received by the extension.

<table id="bkmrk-blockpurposeinbound-"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Inbound recording policy</td><td>Controls whether inbound calls are recorded and whether recording privacy behavior is enabled.</td></tr><tr><td>Recording notifications</td><td>When enabled, recordings can be mailed and processed according to tenant recording settings.</td></tr></tbody></table>

## Outbound Recording

<figure id="bkmrk-outbound-recording-s">![Outbound Recording section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/KYEchan-sip-outbound-recording.png)<figcaption>Outbound Recording section for chan\_sip extension 100.</figcaption></figure>Use this section for recording and post-processing behavior applied to calls placed by the extension.

<table id="bkmrk-blockpurposealways-r"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Always record</td><td>Controls whether outbound calls from this extension are recorded, unless tenant-wide settings force recording.</td></tr><tr><td>Email recording to</td><td>Sends matching recordings to the configured address. Minimum size can suppress very small recordings.</td></tr><tr><td>Transcript, summary, sentiment</td><td>Enables transcript, summary, and sentiment processing when the tenant supports those services.</td></tr></tbody></table>

## Security

<figure id="bkmrk-security-section-for">![Security section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/DMfchan-sip-security.png)<figcaption>Security section for chan\_sip extension 100.</figcaption></figure>Use this section to restrict registration, authentication, abuse behavior, cost limits, and outbound availability.

<table id="bkmrk-blockpurposeauthenti"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Authentication and network filters</td><td>Controls endpoint trust, allowed IPs, and authentication-related behavior.</td></tr><tr><td>Abuse detection and cost limits</td><td>Locks or warns on suspicious or excessive usage according to tenant policy.</td></tr><tr><td>Outbound destinations</td><td>Allows all calls, blocks calls, or applies a destination regex filter.</td></tr><tr><td>Lock PIN and max duration</td><td>Allows the extension to be locked and caps outbound call duration.</td></tr><tr><td>Working hours</td><td>Restricts outbound calling to the selected weekday condition.</td></tr></tbody></table>

## Web User Panel and Switchboard

<figure id="bkmrk-web-user-panel-and-s-1">![Web User Panel and Switchboard section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/aVpchan-sip-web-user-panel-and-switchboard.png)<figcaption>Web User Panel and Switchboard section for chan\_sip extension 100.</figcaption></figure>Use this section to enable user-facing web access and related application permissions for the extension.

<table id="bkmrk-blockpurposeaccess-t"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Access toggles</td><td>Enables the user panel, web phone, switchboard, and optional custom user application.</td></tr><tr><td>Web user and password</td><td>Sets the login identity and password. If no web user is specified, the endpoint username is used.</td></tr><tr><td>Password policy and 2FA</td><td>Controls expiry, forced change, lock state, LDAP use, and two-factor authentication.</td></tr><tr><td>Email, profile, and IP filter</td><td>Sets the user email, sends account information, assigns a user profile, and optionally restricts web access by IP.</td></tr></tbody></table>

## Outbound Calls

<figure id="bkmrk-outbound-calls-secti">![Outbound Calls section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/ASkchan-sip-outbound-calls.png)<figcaption>Outbound Calls section for chan\_sip extension 100.</figcaption></figure>Use this section to control the caller ID, emergency caller ID, area-code handling, dialing filters, routing profile, and call rate used by outbound calls.

<table id="bkmrk-blockpurposeexternal"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>External caller ID</td><td>Sets or hides the caller ID number and name sent on outbound calls.</td></tr><tr><td>SMS and override caller ID</td><td>Controls SMS caller ID and optional SIP header based caller ID overrides.</td></tr><tr><td>Emergency caller ID</td><td>Defines the emergency number identity and whether empty emergency caller ID warnings are ignored.</td></tr><tr><td>Area code and caller ID regex</td><td>Applies prefixes and caller ID rewrite rules before routing.</td></tr><tr><td>Do Not and Only Allow lists</td><td>Applies tenant call-list restrictions to this extension.</td></tr><tr><td>Routing profile and call rate</td><td>Selects the routing profile, SMS routing profile, and client rate used by calls.</td></tr></tbody></table>

## Inbound Calls

<figure id="bkmrk-inbound-calls-sectio">![Inbound Calls section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/LaMchan-sip-inbound-calls.png)<figcaption>Inbound Calls section for chan\_sip extension 100.</figcaption></figure>Use this section for inbound caller ID privacy controls.

<table id="bkmrk-blockpurposeblock-in"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Block inbound caller ID number</td><td>Prevents the caller ID number from being shown to this extension.</td></tr><tr><td>Block inbound caller ID name</td><td>Prevents the caller ID name from being shown to this extension.</td></tr></tbody></table>

## Find me/Follow me Configuration

<figure id="bkmrk-find-me%2Ffollow-me-co-1">![Find me/Follow me Configuration section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/kLechan-sip-find-me-follow-me-configuration.png)<figcaption>Find me/Follow me Configuration section for chan\_sip extension 100.</figcaption></figure>Use this section to forward calls to an alternate number when find-me/follow-me is enabled.

<table id="bkmrk-blockpurposefmfm-num"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>FMFM number and status</td><td>Sets the external follow-me number and enables or disables the feature.</td></tr><tr><td>Condition and dial method</td><td>Limits follow-me behavior to a condition and selects how the alternate number is dialed.</td></tr><tr><td>Confirmation and messages</td><td>Requires answer confirmation and selects confirm/hold messages.</td></tr><tr><td>Caller ID and timing</td><td>Controls caller ID presentation, prefixes, delay, and dial timeout for the follow-me call.</td></tr></tbody></table>

## Additional Destinations - Active if checked

<figure id="bkmrk-additional-destinati-1">![Additional Destinations - Active if checked section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/GnWchan-sip-additional-destinations-active-if-checked.png)<figcaption>Additional Destinations - Active if checked section for chan\_sip extension 100.</figcaption></figure>Use this section to define failover or conditional routing for calls that do not complete normally.

<table id="bkmrk-blockpurposeuncondit"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Unconditional</td><td>Always routes calls to the selected destination when enabled.</td></tr><tr><td>On no answer, busy, or offline</td><td>Routes calls when the extension does not answer, is busy, or is offline.</td></tr><tr><td>On condition</td><td>Routes calls to a selected destination when the chosen condition matches.</td></tr><tr><td>Missed call notification</td><td>Sends email notifications for missed calls, with options to ignore internal or queue-originated calls.</td></tr></tbody></table>

## Note

<figure id="bkmrk-note-section-for-cha">![Note section for chan_sip extension 100.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/PSichan-sip-note.png)<figcaption>Note section for chan\_sip extension 100.</figcaption></figure>Use this section for administrative classification and free-form notes, then save or delete the extension.

<table id="bkmrk-blockpurposebranch-a"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Branch and department</td><td>Classifies the extension for reporting and administration.</td></tr><tr><td>Reference ID and additional info</td><td>Stores external references and notes.</td></tr><tr><td>Save, delete, and back</td><td>Save applies changes, Delete removes the extension when allowed, and Back returns to the Extensions list.</td></tr></tbody></table>

# Create and Edit PJSIP Extensions

Use this page to create or edit a phone extension that registers as a PJSIP endpoint. The form works against the tenant currently selected in the top bar.

The screenshots use the **Canistracci Oil** demo extension **101 Bella Stone**. Creating and editing use the same form: a new extension opens with tenant defaults, while an existing extension opens with saved values.

## Creating and editing

<table id="bkmrk-actiondescriptioncre"><thead><tr><th>Action</th><th>Description</th></tr></thead><tbody><tr><td>Create</td><td>Open Configuration &gt; Extensions and select New PJSIP peer. Fill the required fields and select Save.</td></tr><tr><td>Edit</td><td>Open an existing extension from the Extensions list. Update the required fields and select Save.</td></tr><tr><td>Delete</td><td>When delete permission is available, open the extension and select Delete. Confirm only after checking routing, phones, queues, and other references.</td></tr></tbody></table>

For PJSIP extensions, the endpoint username normally uses the extension number, a hyphen, and the tenant code, such as 101-CANISTRACCI. Press the swapped-arrow icon beside Username to switch the separator from a hyphen to an underscore, for example 101\_CANISTRACCI. If custom usernames are enabled in Admin &gt; Settings, you can enter a username that does not follow the generated tenant-code pattern.

## Information

<figure id="bkmrk-information-section-">![Information section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/3yqpjsip-information.png)<figcaption>Information section for PJSIP extension 101.</figcaption></figure>Use this section for the extension identity, endpoint credentials, media basics, groups, voicemail message-waiting indication, DND state, and inbound ring timeout.

<table id="bkmrk-blockpurposenumber-a"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Number and name</td><td>Number is the internal extension number. Name is the display name used in lists, caller ID, and reports.</td></tr><tr><td>Description and emergency notes</td><td>Description is an administrator note. Emergency notes can be used by emergency routing and notification logic.</td></tr><tr><td>SIP stack</td><td>Shows whether the endpoint is using chan\_sip or PJSIP. Users with switch permission can change the stack from this form or from the Extensions list.</td></tr><tr><td>Username and password</td><td>Endpoint credentials used by the phone or softphone. The default username pattern is the extension number followed by the tenant code.</td></tr><tr><td>Codecs and DTMF</td><td>Controls the allowed audio/video codecs and DTMF signaling mode used by the endpoint.</td></tr><tr><td>Media and groups</td><td>Direct media, call groups, pickup groups, spy groups, and message-waiting options control how the endpoint participates in calls and monitoring.</td></tr><tr><td>Voicemail, DND, and timeout</td><td>Voicemail MWI, DND, and inbound dial timeout control how incoming calls are presented and how long the extension rings.</td></tr></tbody></table>

### Trunk mode

<figure id="bkmrk-additional-trunk-mod">![Additional trunk mode options visible after enabling Trunk on a PJSIP extension.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/pjsip-trunk-mode-options.png)<figcaption>Additional trunk mode options visible after enabling Trunk on a PJSIP extension.</figcaption></figure>Enable **Trunk** only when the PJSIP endpoint is another PBX, gateway, or upstream device that should receive calls by dialed number rather than as a single telephone endpoint. A normal phone extension should usually leave this option disabled.

<table id="bkmrk-field-or-optioneffec"><thead><tr><th>Field or option</th><th>Effect</th></tr></thead><tbody><tr><td>Trunk</td><td>Changes how calls are sent to the endpoint. With trunk mode disabled, MiRTA PBX dials the PJSIP endpoint contacts as a phone endpoint. With trunk mode enabled, MiRTA PBX sends the called number to the endpoint, or the configured DID override when one is set.</td></tr><tr><td>DID Number</td><td>Automatic sends the original called number to the peer. Set to sends the value entered in the DID number field instead, which is useful when the downstream PBX or gateway expects a fixed pilot number or a rewritten DID.</td></tr><tr><td>CallerID Number Override</td><td>Controls which outbound caller ID values are preserved from the SIP INVITE received from the trunk device. The default behavior can keep both caller ID name and number from the INVITE. The other choices keep only the number, keep only the name, or ignore the INVITE caller ID and use the caller ID configured on the extension.</td></tr><tr><td>Emergency CallerID Number Override</td><td>For emergency routes, Get Emergency CallerID from SIP Invite allows the emergency caller ID sent by the trunk device to pass through. Do not use Emergency CallerID from SIP Invite makes MiRTA PBX replace it with the extension emergency caller ID, or the tenant default emergency caller ID when the extension does not define one.</td></tr><tr><td>CallerID Number Source</td><td>Selects where inbound trunk caller ID is read from when a specific source is required. Automatic keeps the caller ID parsed by Asterisk. The explicit choices read the From, P-Asserted-Identity, P-Preferred-Identity, or Remote-Party-ID header and use it to set caller ID before routing.</td></tr></tbody></table>

In the dialplan, PJSIP trunk mode affects both direct endpoint dialing and registered-contact dialing. When contacts are used, MiRTA PBX rewrites the PJSIP contact URI user part from the endpoint identity to the dialed number, or to the DID override. If the endpoint is registered on another node, MiRTA PBX sends the call through the configured inter-node SIP trunking module.

## NAT Control

<figure id="bkmrk-nat-control-section-">![NAT Control section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/itwpjsip-nat-control.png)<figcaption>NAT Control section for PJSIP extension 101.</figcaption></figure>Use this section to control endpoint reachability and keepalive behavior for devices behind NAT or with changing network paths.

<table id="bkmrk-blockpurposenatdefin"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>NAT</td><td>Defines how MiRTA PBX treats NAT traversal for the endpoint.</td></tr><tr><td>Qualify and qualify frequency</td><td>Controls whether the PBX checks endpoint reachability and how often checks are sent.</td></tr><tr><td>Keep alive and RTP keep alive</td><td>Sends periodic traffic to keep network mappings open and detect unavailable devices.</td></tr></tbody></table>

## Call Settings

<figure id="bkmrk-call-settings-sectio">![Call Settings section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/ClHpjsip-call-settings.png)<figcaption>Call Settings section for PJSIP extension 101.</figcaption></figure>Use this section for call behavior that is not specific to inbound or outbound routing.

<table id="bkmrk-blockpurposefax-and-"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Fax and volume</td><td>Controls T.38 fax behavior and transmit/receive volume adjustments.</td></tr><tr><td>Music on hold and language</td><td>Selects media behavior and the preferred language for prompts played to the extension.</td></tr><tr><td>Directories and phone books</td><td>Controls whether the extension appears in dial-by-name directories and phone book generated lists.</td></tr><tr><td>Call waiting and autoanswer</td><td>Controls second-call handling and optional automatic answer behavior for supported phones.</td></tr></tbody></table>

## Inbound Recording

<figure id="bkmrk-inbound-recording-se">![Inbound Recording section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/yR3pjsip-inbound-recording.png)<figcaption>Inbound Recording section for PJSIP extension 101.</figcaption></figure>Use this section for recording behavior applied to calls received by the extension.

<table id="bkmrk-blockpurposeinbound-"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Inbound recording policy</td><td>Controls whether inbound calls are recorded and whether recording privacy behavior is enabled.</td></tr><tr><td>Recording notifications</td><td>When enabled, recordings can be mailed and processed according to tenant recording settings.</td></tr></tbody></table>

## Outbound Recording

<figure id="bkmrk-outbound-recording-s">![Outbound Recording section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/PPlpjsip-outbound-recording.png)<figcaption>Outbound Recording section for PJSIP extension 101.</figcaption></figure>Use this section for recording and post-processing behavior applied to calls placed by the extension.

<table id="bkmrk-blockpurposealways-r"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Always record</td><td>Controls whether outbound calls from this extension are recorded, unless tenant-wide settings force recording.</td></tr><tr><td>Email recording to</td><td>Sends matching recordings to the configured address. Minimum size can suppress very small recordings.</td></tr><tr><td>Transcript, summary, sentiment</td><td>Enables transcript, summary, and sentiment processing when the tenant supports those services.</td></tr></tbody></table>

## Security

<figure id="bkmrk-security-section-for">![Security section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/IaIpjsip-security.png)<figcaption>Security section for PJSIP extension 101.</figcaption></figure>Use this section to restrict registration, authentication, abuse behavior, cost limits, and outbound availability.

<table id="bkmrk-blockpurposeauthenti"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Authentication and network filters</td><td>Controls endpoint trust, allowed IPs, and authentication-related behavior.</td></tr><tr><td>Abuse detection and cost limits</td><td>Locks or warns on suspicious or excessive usage according to tenant policy.</td></tr><tr><td>Outbound destinations</td><td>Allows all calls, blocks calls, or applies a destination regex filter.</td></tr><tr><td>Lock PIN and max duration</td><td>Allows the extension to be locked and caps outbound call duration.</td></tr><tr><td>Working hours</td><td>Restricts outbound calling to the selected weekday condition.</td></tr></tbody></table>

## Web User Panel and Switchboard

<figure id="bkmrk-web-user-panel-and-s-1">![Web User Panel and Switchboard section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/RZFpjsip-web-user-panel-and-switchboard.png)<figcaption>Web User Panel and Switchboard section for PJSIP extension 101.</figcaption></figure>Use this section to enable user-facing web access and related application permissions for the extension.

<table id="bkmrk-blockpurposeaccess-t"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Access toggles</td><td>Enables the user panel, web phone, switchboard, and optional custom user application.</td></tr><tr><td>Web user and password</td><td>Sets the login identity and password. If no web user is specified, the endpoint username is used.</td></tr><tr><td>Password policy and 2FA</td><td>Controls expiry, forced change, lock state, LDAP use, and two-factor authentication.</td></tr><tr><td>Email, profile, and IP filter</td><td>Sets the user email, sends account information, assigns a user profile, and optionally restricts web access by IP.</td></tr></tbody></table>

## Outbound Calls

<figure id="bkmrk-outbound-calls-secti">![Outbound Calls section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/ukGpjsip-outbound-calls.png)<figcaption>Outbound Calls section for PJSIP extension 101.</figcaption></figure>Use this section to control the caller ID, emergency caller ID, area-code handling, dialing filters, routing profile, and call rate used by outbound calls.

<table id="bkmrk-blockpurposeexternal"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>External caller ID</td><td>Sets or hides the caller ID number and name sent on outbound calls.</td></tr><tr><td>SMS and override caller ID</td><td>Controls SMS caller ID and optional SIP header based caller ID overrides.</td></tr><tr><td>Emergency caller ID</td><td>Defines the emergency number identity and whether empty emergency caller ID warnings are ignored.</td></tr><tr><td>Area code and caller ID regex</td><td>Applies prefixes and caller ID rewrite rules before routing.</td></tr><tr><td>Do Not and Only Allow lists</td><td>Applies tenant call-list restrictions to this extension.</td></tr><tr><td>Routing profile and call rate</td><td>Selects the routing profile, SMS routing profile, and client rate used by calls.</td></tr></tbody></table>

## Inbound Calls

<figure id="bkmrk-inbound-calls-sectio">![Inbound Calls section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/aiVpjsip-inbound-calls.png)<figcaption>Inbound Calls section for PJSIP extension 101.</figcaption></figure>Use this section for inbound caller ID privacy controls.

<table id="bkmrk-blockpurposeblock-in"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Block inbound caller ID number</td><td>Prevents the caller ID number from being shown to this extension.</td></tr><tr><td>Block inbound caller ID name</td><td>Prevents the caller ID name from being shown to this extension.</td></tr></tbody></table>

## Find me/Follow me Configuration

<figure id="bkmrk-find-me%2Ffollow-me-co-1">![Find me/Follow me Configuration section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/BwKpjsip-find-me-follow-me-configuration.png)<figcaption>Find me/Follow me Configuration section for PJSIP extension 101.</figcaption></figure>Use this section to forward calls to an alternate number when find-me/follow-me is enabled.

<table id="bkmrk-blockpurposefmfm-num"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>FMFM number and status</td><td>Sets the external follow-me number and enables or disables the feature.</td></tr><tr><td>Condition and dial method</td><td>Limits follow-me behavior to a condition and selects how the alternate number is dialed.</td></tr><tr><td>Confirmation and messages</td><td>Requires answer confirmation and selects confirm/hold messages.</td></tr><tr><td>Caller ID and timing</td><td>Controls caller ID presentation, prefixes, delay, and dial timeout for the follow-me call.</td></tr></tbody></table>

## Additional Destinations - Active if checked

<figure id="bkmrk-additional-destinati-1">![Additional Destinations - Active if checked section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/7I3pjsip-additional-destinations-active-if-checked.png)<figcaption>Additional Destinations - Active if checked section for PJSIP extension 101.</figcaption></figure>Use this section to define failover or conditional routing for calls that do not complete normally.

<table id="bkmrk-blockpurposeuncondit"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Unconditional</td><td>Always routes calls to the selected destination when enabled.</td></tr><tr><td>On no answer, busy, or offline</td><td>Routes calls when the extension does not answer, is busy, or is offline.</td></tr><tr><td>On condition</td><td>Routes calls to a selected destination when the chosen condition matches.</td></tr><tr><td>Missed call notification</td><td>Sends email notifications for missed calls, with options to ignore internal or queue-originated calls.</td></tr></tbody></table>

## Note

<figure id="bkmrk-note-section-for-pjs">![Note section for PJSIP extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/wzapjsip-note.png)<figcaption>Note section for PJSIP extension 101.</figcaption></figure>Use this section for administrative classification and free-form notes, then save or delete the extension.

<table id="bkmrk-blockpurposebranch-a"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Branch and department</td><td>Classifies the extension for reporting and administration.</td></tr><tr><td>Reference ID and additional info</td><td>Stores external references and notes.</td></tr><tr><td>Save, delete, and back</td><td>Save applies changes, Delete removes the extension when allowed, and Back returns to the Extensions list.</td></tr></tbody></table>

# Edit PJSIP Endpoint

Use this page to tune the PJSIP endpoint behavior behind a PJSIP extension. The settings here control media negotiation, NAT behavior, DTLS certificate handling, and transport-related media addressing. The screenshots use the **Canistracci Oil** demo PJSIP extension **101 Bella Stone**.

## Opening and saving

<table id="bkmrk-actiondescriptionope"><thead><tr><th>Action</th><th>Description</th></tr></thead><tbody><tr><td>Open</td><td>Open Configuration &gt; Extensions, edit a PJSIP extension, then choose the Endpoint detail link.</td></tr><tr><td>Edit</td><td>Update the required fields and select Save. The form returns to the PJSIP extension after saving.</td></tr><tr><td>Back</td><td>Use Back to return to the PJSIP extension without applying changes.</td></tr></tbody></table>

## Information

<figure id="bkmrk-information-section-">![Information section for PJSIP endpoint for extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/endpoint-information.png)<figcaption>Information section for PJSIP endpoint for extension 101.</figcaption></figure>Use this section for media path behavior, contact rewriting, connected-line signaling, NAT behavior, T.38 behavior, packetization, RTCP multiplexing, and ring-in-use notifications.

<table id="bkmrk-field-or-optionpurpo"><thead><tr><th>Field or option</th><th>Purpose</th></tr></thead><tbody><tr><td>Direct Media</td><td>Determines whether media may flow directly between endpoints</td></tr><tr><td>Rewrite Contact</td><td>Allow Contact header to be rewritten with the source IP address-port</td></tr><tr><td>Connected Line Method</td><td>Connected line media type</td></tr><tr><td>DirectMedia Method</td><td>Direct Media method type</td></tr><tr><td>Direct Media Glare Mitigation</td><td>Mitigation of direct media re INVITE glare</td></tr><tr><td>Disable direct media on NAT</td><td>Disable direct media session refreshes when NAT obstructs the media session</td></tr><tr><td>Force rport</td><td>Force use of return port</td></tr><tr><td>Outbound Proxy</td><td>Proxy through which to send requests a full SIP URI must be provided</td></tr><tr><td>RTP Symmetric</td><td>Enforce that RTP must be symmetric</td></tr><tr><td>T.38 UDPTL NAT</td><td>Use the NATTED IP in the UDPTL for T.38</td></tr><tr><td>RPID Immediate</td><td>Immediately send connected line updates on unanswered incoming calls</td></tr><tr><td>Use ptime</td><td>Use Endpoint's requested packetization interval</td></tr><tr><td>RTCP Mux</td><td>Controls whether RTP and RTCP can be multiplexed on the same transport flow.</td></tr><tr><td>Notify Ringing when Ring in Use</td><td>When an extension is in Ring in Use state, notifies the ringing</td></tr></tbody></table>

## Security

<figure id="bkmrk-security-section-for">![Security section for PJSIP endpoint for extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/endpoint-security.png)<figcaption>Security section for PJSIP endpoint for extension 101.</figcaption></figure>Use this section for DTLS certificate settings used by secure media and WebRTC-style endpoint behavior.

<table id="bkmrk-field-or-optionpurpo-1"><thead><tr><th>Field or option</th><th>Purpose</th></tr></thead><tbody><tr><td>DTLS certificate file path</td><td>Path to certificate file to present to peer</td></tr><tr><td>DTLS CA certificate file path</td><td>Path to certificate authority certificate</td></tr><tr><td>DTLS Auto generate certificate</td><td>Enable ephemeral DTLS certificate generation</td></tr></tbody></table>

## Transport

<figure id="bkmrk-transport-section-fo">![Transport section for PJSIP endpoint for extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/endpoint-transport.png)<figcaption>Transport section for PJSIP endpoint for extension 101.</figcaption></figure>Use this section for the external media address used in RTP handling.

<table id="bkmrk-field-or-optionpurpo-2"><thead><tr><th>Field or option</th><th>Purpose</th></tr></thead><tbody><tr><td>External Media Address</td><td>External IP address to use in RTP handling</td></tr></tbody></table>

# Edit PJSIP AOR

Use this page to tune the PJSIP Address of Record for a PJSIP extension. These settings control registration contact limits, contact expiration timing, mailbox subscription hints, and Path support. The screenshots use the **Canistracci Oil** demo PJSIP extension **101 Bella Stone**.

## Opening and saving

<table id="bkmrk-actiondescriptionope"><thead><tr><th>Action</th><th>Description</th></tr></thead><tbody><tr><td>Open</td><td>Open Configuration &gt; Extensions, edit a PJSIP extension, then choose the AOR detail link.</td></tr><tr><td>Edit</td><td>Update the required fields and select Save. The form returns to the PJSIP extension after saving.</td></tr><tr><td>Back</td><td>Use Back to return to the PJSIP extension without applying changes.</td></tr></tbody></table>

## Information

<figure id="bkmrk-information-section-">![Information section for PJSIP AOR for extension 101.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/aor-information.png)<figcaption>Information section for PJSIP AOR for extension 101.</figcaption></figure>Use this section for contact expiration limits, mailbox subscriptions, maximum registered contacts, registration contact cleanup, and Path support.

<table id="bkmrk-field-or-optionpurpo"><thead><tr><th>Field or option</th><th>Purpose</th></tr></thead><tbody><tr><td>Default Expiration</td><td>Default expiration time in seconds for contacts that are dynamically bound to an AoR</td></tr><tr><td>Minimum Expiration</td><td>Minimum expiration time in seconds for contacts that are dynamically bound to an AoR</td></tr><tr><td>Maximum Expiration</td><td>Maximum expiration time in seconds for contacts that are dynamically bound to an AoR</td></tr><tr><td>Mailboxes</td><td>Allow subscriptions for the specified mailbox(es)</td></tr><tr><td>Max Contacts</td><td>Maximum number of contacts that can bind to an AoR</td></tr><tr><td>Remove Existing</td><td>On receiving a new registration to the AoR should it remove enough existing contacts not added or updated by the registration to satisfy Max Contacts? Any removed contacts will expire the soonest.</td></tr><tr><td>Remove Unavailable</td><td>On receiving a new registration to the AoR should it remove unavailable contacts not added or updated by the registration to satisfy Max Contacts?</td></tr><tr><td>Support Path</td><td>Enables Path support for REGISTER requests and Route support for other requests.</td></tr></tbody></table>

# Create and Edit Custom Extensions

Use this page to create or edit an extension that routes to a custom dial target or external endpoint behavior. The form works against the tenant currently selected in the top bar.

The screenshots use the **Canistracci Oil** demo extension **106 Gia Parker**. Creating and editing use the same form: a new extension opens with tenant defaults, while an existing extension opens with saved values.

## Creating and editing

<table id="bkmrk-actiondescriptioncre"><thead><tr><th>Action</th><th>Description</th></tr></thead><tbody><tr><td>Create</td><td>Open Configuration &gt; Extensions and select Custom Extension. Fill the required fields and select Save.</td></tr><tr><td>Edit</td><td>Open an existing extension from the Extensions list. Update the required fields and select Save.</td></tr><tr><td>Delete</td><td>When delete permission is available, open the extension and select Delete. Confirm only after checking routing, phones, queues, and other references.</td></tr></tbody></table>

## Information

<figure id="bkmrk-information-section-">![Information section for custom extension 106.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/JRKcustom-information.png)<figcaption>Information section for custom extension 106.</figcaption></figure>Use this section for the custom extension identity, call/pickup groups, DND state, and inbound timeout.

<table id="bkmrk-blockpurposenumber%2C-"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Number, name, and description</td><td>Defines the internal extension number, display name, and administrator description.</td></tr><tr><td>Call and pickup groups</td><td>Controls pickup behavior and group membership for incoming calls.</td></tr><tr><td>DND and inbound timeout</td><td>Controls whether the custom extension is marked DND and how long incoming calls are attempted.</td></tr></tbody></table>

## Call Settings

<figure id="bkmrk-call-settings-sectio">![Call Settings section for custom extension 106.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/mC3custom-call-settings.png)<figcaption>Call Settings section for custom extension 106.</figcaption></figure>Use this section for media and listing behavior applied to the custom extension.

<table id="bkmrk-blockpurposefax-and-"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Fax and volume</td><td>Controls fax behavior and transmit/receive volume adjustments.</td></tr><tr><td>Music on hold and language</td><td>Selects hold media and prompt language.</td></tr><tr><td>Directories and phone books</td><td>Controls inclusion in dial-by-name and phone book generated lists.</td></tr><tr><td>Call waiting and autoanswer</td><td>Controls second-call handling and autoanswer behavior when supported by the target.</td></tr></tbody></table>

## Outbound Recording

<figure id="bkmrk-outbound-recording-s">![Outbound Recording section for custom extension 106.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/DLkcustom-outbound-recording.png)<figcaption>Outbound Recording section for custom extension 106.</figcaption></figure>Use this section for outbound recording and optional recording processing.

<table id="bkmrk-blockpurposealways-r"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Always record and email recording</td><td>Controls outbound recording and optional delivery of recordings by email.</td></tr><tr><td>Transcript, summary, sentiment</td><td>Enables transcript, summary, and sentiment processing when available for the tenant.</td></tr></tbody></table>

## Security

<figure id="bkmrk-security-section-for">![Security section for custom extension 106.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/p9dcustom-security.png)<figcaption>Security section for custom extension 106.</figcaption></figure>Use this section to define the custom dial target and restrict how the custom extension can be used.

<table id="bkmrk-blockpurposeoutbound"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Outbound number</td><td>Defines the number or dial target used to reach the custom extension.</td></tr><tr><td>Caller ID and authentication</td><td>Controls caller ID use on internal calls and the authentication method expected for inbound matching.</td></tr><tr><td>Allowed providers and Teams ID</td><td>Restricts inbound providers and stores a Teams extension ID when Teams status integration is used.</td></tr><tr><td>Abuse, cost, and destination limits</td><td>Applies abuse detection, call cost limits, outbound destination filters, lock PIN, maximum duration, and working-hours restrictions.</td></tr></tbody></table>

## Web User Panel

<figure id="bkmrk-web-user-panel-secti">![Web User Panel section for custom extension 106.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Uqfcustom-web-user-panel.png)<figcaption>Web User Panel section for custom extension 106.</figcaption></figure>Use this section to enable web access for the custom extension user.

<table id="bkmrk-blockpurposeuser-pan"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>User panel toggle</td><td>Enables or disables web access for this extension.</td></tr><tr><td>Web user and password</td><td>Sets the login identity and password.</td></tr><tr><td>LDAP, 2FA, email, and profile</td><td>Controls external authentication, two-factor options, notification email, and user profile.</td></tr></tbody></table>

## Outbound Calls

<figure id="bkmrk-outbound-calls-secti">![Outbound Calls section for custom extension 106.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Hwpcustom-outbound-calls.png)<figcaption>Outbound Calls section for custom extension 106.</figcaption></figure>Use this section to control outbound caller ID, emergency caller ID, prefixes, call lists, routing profile, and call rate.

<table id="bkmrk-blockpurposeexternal"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>External caller ID</td><td>Sets caller ID number and name used by outbound calls.</td></tr><tr><td>Caller ID regex and emergency caller ID</td><td>Applies rewrite rules and emergency identity settings.</td></tr><tr><td>Area code and call lists</td><td>Applies area-code prefixes and Do Not or Only Allow list restrictions.</td></tr><tr><td>Routing profile and call rate</td><td>Selects the routing profile and call rate used by outbound calls.</td></tr></tbody></table>

## Find me/Follow me Configuration

<figure id="bkmrk-find-me%2Ffollow-me-co-1">![Find me/Follow me Configuration section for custom extension 106.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Cmscustom-find-me-follow-me-configuration.png)<figcaption>Find me/Follow me Configuration section for custom extension 106.</figcaption></figure>Use this section to send calls to a follow-me destination under controlled conditions.

<table id="bkmrk-blockpurposefmfm-num"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>FMFM number and dial method</td><td>Sets the follow-me target and how it is dialed.</td></tr><tr><td>Confirmation and caller ID</td><td>Controls answer confirmation and caller ID behavior.</td></tr><tr><td>Delay and timeout</td><td>Controls how long to wait before and during follow-me dialing.</td></tr></tbody></table>

## Additional Destinations - Active if checked

<figure id="bkmrk-additional-destinati-1">![Additional Destinations - Active if checked section for custom extension 106.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Xn7custom-additional-destinations-active-if-checked.png)<figcaption>Additional Destinations - Active if checked section for custom extension 106.</figcaption></figure>Use this section to route calls that are not answered, are busy, are offline, or meet a condition.

<table id="bkmrk-blockpurposefailover"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Failover destinations</td><td>Selects unconditional, no-answer, busy, offline, and conditional destinations.</td></tr><tr><td>Missed call notifications</td><td>Sends notifications and optionally ignores internal or queue-originated missed calls.</td></tr></tbody></table>

## Note

<figure id="bkmrk-note-section-for-cus">![Note section for custom extension 106.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/a8Ccustom-note.png)<figcaption>Note section for custom extension 106.</figcaption></figure>Use this section for administrative metadata and final actions.

<table id="bkmrk-blockpurposebranch%2C-"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Branch, department, reference ID</td><td>Classifies the extension and stores external references.</td></tr><tr><td>Additional info</td><td>Stores free-form notes.</td></tr><tr><td>Save, delete, and back</td><td>Save applies changes, Delete removes the extension when allowed, and Back returns to the Extensions list.</td></tr></tbody></table>

# Create and Edit Virtual Extensions

Use this page to create or edit a virtual extension that groups real extensions behind a single internal number. The form works against the tenant currently selected in the top bar.

The screenshots use the **Canistracci Oil** demo extension **108 Ivy Morgan**. Creating and editing use the same form: a new extension opens with tenant defaults, while an existing extension opens with saved values.

## Creating and editing

<table id="bkmrk-actiondescriptioncre"><thead><tr><th>Action</th><th>Description</th></tr></thead><tbody><tr><td>Create</td><td>Open Configuration &gt; Extensions and select Virtual Extension. Fill the required fields and select Save.</td></tr><tr><td>Edit</td><td>Open an existing extension from the Extensions list. Update the required fields and select Save.</td></tr><tr><td>Delete</td><td>When delete permission is available, open the extension and select Delete. Confirm only after checking routing, phones, queues, and other references.</td></tr></tbody></table>

## Information

<figure id="bkmrk-information-section-">![Information section for virtual extension 108.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/3Kevirtual-information.png)<figcaption>Information section for virtual extension 108.</figcaption></figure>Use this section for the virtual extension identity, member extensions, security PIN, caller ID, groups, voicemail MWI, DND state, and inbound timeout.

<table id="bkmrk-blockpurposenumber%2C-"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Number, name, and description</td><td>Defines the internal virtual extension number, display name, and administrator description.</td></tr><tr><td>Security PIN</td><td>Requests a PIN when an extension tries to join the virtual extension.</td></tr><tr><td>Internal caller ID</td><td>Sets the caller ID shown for internal calls, or keeps it automatic.</td></tr><tr><td>Extensions</td><td>Selects the real extensions that belong to the virtual extension.</td></tr><tr><td>Groups, voicemail, DND, timeout</td><td>Controls call/pickup/spy groups, voicemail MWI, DND state, and inbound ring timeout.</td></tr></tbody></table>

## Call Settings

<figure id="bkmrk-call-settings-sectio">![Call Settings section for virtual extension 108.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/apUvirtual-call-settings.png)<figcaption>Call Settings section for virtual extension 108.</figcaption></figure>Use this section for virtual extension call behavior and listing options.

<table id="bkmrk-blockpurposevolume-a"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Volume and music on hold</td><td>Adjusts audio levels and selects hold media.</td></tr><tr><td>Directories and phone books</td><td>Controls inclusion in dial-by-name and phone book generated lists.</td></tr><tr><td>Call waiting and parking lot</td><td>Controls server-side call waiting behavior and parking lot selection.</td></tr></tbody></table>

## Outbound Recording

<figure id="bkmrk-outbound-recording-s">![Outbound Recording section for virtual extension 108.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Ptwvirtual-outbound-recording.png)<figcaption>Outbound Recording section for virtual extension 108.</figcaption></figure>Use this section for outbound recording and optional recording processing.

<table id="bkmrk-blockpurposealways-r"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Always record and email recording</td><td>Controls outbound recording and optional delivery of recordings by email.</td></tr><tr><td>Transcript, summary, sentiment</td><td>Enables transcript, summary, and sentiment processing when available for the tenant.</td></tr></tbody></table>

## Security

<figure id="bkmrk-security-section-for">![Security section for virtual extension 108.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/iduvirtual-security.png)<figcaption>Security section for virtual extension 108.</figcaption></figure>Use this section to limit outbound usage from the virtual extension.

<table id="bkmrk-blockpurposeoutbound"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Outbound destinations</td><td>Allows all calls, blocks calls, or applies a destination regex filter.</td></tr><tr><td>Lock PIN and max duration</td><td>Allows the virtual extension to be locked and caps outbound call duration.</td></tr><tr><td>Working hours</td><td>Restricts outbound calling to the selected weekday condition.</td></tr></tbody></table>

## Web User Panel

<figure id="bkmrk-web-user-panel-secti">![Web User Panel section for virtual extension 108.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Umxvirtual-web-user-panel.png)<figcaption>Web User Panel section for virtual extension 108.</figcaption></figure>Use this section to enable web access for the virtual extension user.

<table id="bkmrk-blockpurposeuser-pan"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>User panel toggle</td><td>Enables or disables web access for this extension.</td></tr><tr><td>Web user and password</td><td>Sets the login identity and password.</td></tr><tr><td>LDAP, 2FA, email, and profile</td><td>Controls external authentication, two-factor options, notification email, and user profile.</td></tr></tbody></table>

## Outbound Calls

<figure id="bkmrk-outbound-calls-secti">![Outbound Calls section for virtual extension 108.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/rBTvirtual-outbound-calls.png)<figcaption>Outbound Calls section for virtual extension 108.</figcaption></figure>Use this section to control caller ID, area-code handling, dialing filters, and routing for calls placed from the virtual extension.

<table id="bkmrk-blockpurposeexternal"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>External caller ID</td><td>Sets caller ID number and name used by outbound calls.</td></tr><tr><td>Use this caller ID in a virtual extension</td><td>Controls whether member extensions use this caller ID when calls originate through the virtual extension.</td></tr><tr><td>Caller ID regex and area code</td><td>Applies rewrite rules and number prefixes before routing.</td></tr><tr><td>Call lists and routing profile</td><td>Applies Do Not or Only Allow lists and selects the routing profile.</td></tr></tbody></table>

## Find me/Follow me Configuration

<figure id="bkmrk-find-me%2Ffollow-me-co-1">![Find me/Follow me Configuration section for virtual extension 108.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/kemvirtual-find-me-follow-me-configuration.png)<figcaption>Find me/Follow me Configuration section for virtual extension 108.</figcaption></figure>Use this section to send calls to a follow-me destination under controlled conditions.

<table id="bkmrk-blockpurposefmfm-num"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>FMFM number and condition</td><td>Sets the follow-me target and optional condition.</td></tr><tr><td>Dial method and confirmation</td><td>Controls how the follow-me call is dialed and whether answer confirmation is required.</td></tr><tr><td>Caller ID and timing</td><td>Controls caller ID presentation, delay, and timeout.</td></tr></tbody></table>

## Additional Destinations - Active if checked

<figure id="bkmrk-additional-destinati-1">![Additional Destinations - Active if checked section for virtual extension 108.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/80Yvirtual-additional-destinations-active-if-checked.png)<figcaption>Additional Destinations - Active if checked section for virtual extension 108.</figcaption></figure>Use this section to route calls that do not complete normally or that meet a condition.

<table id="bkmrk-blockpurposefailover"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Failover destinations</td><td>Selects unconditional, no-answer, busy, offline, and conditional destinations.</td></tr><tr><td>Missed call notifications</td><td>Sends notifications and optionally ignores internal or queue-originated missed calls.</td></tr></tbody></table>

## Note

<figure id="bkmrk-note-section-for-vir">![Note section for virtual extension 108.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/MCuvirtual-note.png)<figcaption>Note section for virtual extension 108.</figcaption></figure>Use this section for administrative metadata and final actions.

<table id="bkmrk-blockpurposebranch%2C-"><thead><tr><th>Block</th><th>Purpose</th></tr></thead><tbody><tr><td>Branch, department, reference ID</td><td>Classifies the extension and stores external references.</td></tr><tr><td>Additional info</td><td>Stores free-form notes.</td></tr><tr><td>Save, delete, and back</td><td>Save applies changes, Delete removes the extension when allowed, and Back returns to the Extensions list.</td></tr></tbody></table>