Skip to main content

Extensions

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

Extensions page in jqGrid mode with fake demo extensions 100-109.
Extensions page in jqGrid mode with fake demo extensions 100-109.

The page works against the tenant currently selected in the top bar. The screenshotscreenshots showsshow 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 screenshot.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

Extensions page in DataTable display mode with demo extensions 100-109.
Extensions page in DataTable display mode with demo extensions 100-109.

DataTable mode shows the standard table with search, page-size selection, sorting, row checkboxes, and action buttons above the table.

jqGrid mode

Extensions page in jqGrid display mode with demo extensions 100-109.
Extensions page in jqGrid display mode with demo extensions 100-109.

jqGrid mode shows the same extension records in the advanced grid with column filters and grid toolbar actions.

Toolbar actions

Extensions toolbar with creation, display mode, and upload controls.Extensions toolbar with creation, display mode, and upload controls.
Extensions toolbar with creation, display mode, and upload controls.
ActionDescription
New SIP peer / New PJSIP peerCreates a standard phone extension. The visible label follows the tenant's preferred SIP stack.
Bulk SIP peersOpens the bulk creation workflow for adding multiple SIP extensions at once.
Custom ExtensionCreates an extension that routes to a custom dial string or custom endpoint logic.
Virtual ExtensionCreates a virtual extension that can group or reference other extension destinations.
Change to chan_sipConverts selected PJSIP extensions to chan_sip when the administrator has permission to switch phone technology.
Change to PJSIPConverts selected chan_sip extensions to PJSIP when the administrator has permission to switch phone technology.
Delete SelectedDeletes the selected extensions after a confirmation prompt. This action is shown only when delete permission is available.
Display mode toggleSwitches the page between the standard tableDataTable and jqGrid display mode. The screenshot uses jqGrid mode.modes.
CSV/XLS UploadOpens the import page for uploading extension records from a CSV or XLS file.

Extension table

Extensions grid showing mixed SIP, PJSIP, custom, and virtual extensions.Extensions grid showing mixed SIP, PJSIP, custom, and virtual extensions.
Extensions grid showing mixed SIP, PJSIP, custom, and virtual extensions.

Use the table controls to filter, sort, select columns, export data, and move between pages. The checkbox column selects rows for bulk actions.

ColumnDescription
NumberExtension number. When extension status is enabled, an icon indicates registration or device state.
NameExtension display name. Icons can indicate call blocking/filtering, DND, unconditional forwarding, or PIN lock.
DescriptionFree-form extension description. Icons can identify PJSIP, custom, virtual, or recording-related behavior.
TechExtension 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.
UsernameSIP/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.
PasswordEndpoint secret when password display is enabled. Depending on settings, the value can be hidden or revealed with an eye icon.
ActionContains quick actions such as showing the extension call flow. Fast provisioning QR code access can also appear when enabled.

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.