# Shared Provider Fields

These fields appear on the provider page before technology-specific realtime options. Some fields are hidden when they do not apply to the selected provider technology.

## Information

<figure id="bkmrk-provider-information">![Provider Information fields filled with fictional SIP values.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/provider-shared-information.png)<figcaption>Provider Information fields filled with fictional SIP values.</figcaption></figure><table id="bkmrk-fieldapplies-topurpo"><thead><tr><th>Field</th><th>Applies to</th><th>Purpose</th><th>Fictional example</th></tr></thead><tbody><tr><td>**Name**</td><td>All technologies</td><td>Friendly provider name shown in provider lists, route choices, reports, and provider-cost screens.</td><td>`Docs Telecom SIP Trunk`</td></tr><tr><td>**Peer Name**</td><td>All technologies</td><td>Stable technical identifier used by routing and, for realtime accounts, by Asterisk peer or endpoint rows. Keep it unique and avoid spaces.</td><td>`docs_telecom_sip`</td></tr><tr><td>**Technology**</td><td>All technologies</td><td>Selects the provider driver or service type. It controls which realtime and SMS fields are visible.</td><td>`SIP`, `PJSIP`, `IAX2`, `DAHDI`, `LOCAL`, or `SMS`</td></tr><tr><td>**Status**</td><td>All technologies</td><td>Controls whether the provider is usable. Enabled allows inbound and outbound use, Disabled removes it from routing, Only Inbound keeps inbound handling only.</td><td>`Enabled`</td></tr><tr><td>**Provider Costs**</td><td>Existing providers</td><td>Opens the provider-cost editor for rating or cost data associated with the provider.</td><td>Open costs for `Docs Telecom SIP Trunk`</td></tr></tbody></table>

## Outbound Calls

<figure id="bkmrk-outbound-calls-field">![Outbound Calls fields with fictional caller ID, digit, header, and routing values.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/provider-shared-outbound.png)<figcaption>Outbound Calls fields with fictional caller ID, digit, header, and routing values.</figcaption></figure><table id="bkmrk-fieldapplies-topurpo-1"><thead><tr><th>Field</th><th>Applies to</th><th>Purpose</th><th>Fictional example</th></tr></thead><tbody><tr><td>**Additional Header 1-6**</td><td>SIP, PJSIP, IAX2, SMS</td><td>Adds SIP headers or SMS HTTP headers. Use one header per field in `Header-Name: value` format.</td><td>`X-Account-Code: docs-demo`</td></tr><tr><td>**CallerID Presentation**</td><td>SIP, PJSIP, IAX2, DAHDI, LOCAL</td><td>Controls privacy and screening information sent when routing calls through the provider.</td><td>`Auto Privacy, CallerID not screened`</td></tr><tr><td>**Digits to Add**</td><td>All outbound providers</td><td>Prepends digits to the called number before the call or SMS is sent to the provider.</td><td>`+1`</td></tr><tr><td>**Number of digits to Remove**</td><td>All outbound providers</td><td>Removes leading digits from the called number before adding any outbound prefix.</td><td>`1`</td></tr><tr><td>**CallerID Modifications**</td><td>Voice providers</td><td>Optional outbound caller ID modification rule applied before the call leaves through this provider.</td><td>`No Modifications` or `Docs US E164 CallerID`</td></tr><tr><td>**CallerID**</td><td>Voice providers</td><td>Forces a caller ID number for every call using the provider. Leave blank to use extension-derived caller ID.</td><td>`+15551230000`</td></tr><tr><td>**CallerID Name**</td><td>Voice providers</td><td>Forces a caller ID name for every call using the provider. Leave blank to use extension-derived caller ID name.</td><td>`Docs Main`</td></tr><tr><td>**CallerID allowed regex**</td><td>Voice providers</td><td>Validates caller ID numbers accepted by the carrier. If the current caller ID does not match, MiRTA PBX falls back to DID, extension, or tenant defaults.</td><td>`^\+1555[0-9]{7}$`</td></tr><tr><td>**Max outbound channels**</td><td>All outbound providers</td><td>Limits concurrent outbound channels. When the limit is reached, routing skips to another provider. Use Unlimited for no limit.</td><td>`12`</td></tr><tr><td>**Penalty**</td><td>All outbound providers</td><td>Provider selection weight used by routing and round-robin choices. Lower penalty is preferred.</td><td>`10`</td></tr><tr><td>**Ignore SIP Cause codes**</td><td>Voice providers</td><td>Continues to another provider even when this provider returns a SIP failure cause.</td><td>`checked` for fallback routing</td></tr><tr><td>**Ignore BUSY**</td><td>Voice providers</td><td>Continues to another provider when this provider returns BUSY and the route should keep searching.</td><td>`checked` for multi-carrier routes</td></tr></tbody></table>

## Inbound Calls

<figure id="bkmrk-inbound-calls-fields">![Inbound Calls fields with fictional DID normalization and user variables.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/provider-shared-inbound.png)<figcaption>Inbound Calls fields with fictional DID normalization and user variables.</figcaption></figure><table id="bkmrk-fieldapplies-topurpo-2"><thead><tr><th>Field</th><th>Applies to</th><th>Purpose</th><th>Fictional example</th></tr></thead><tbody><tr><td>**Inbound Digits to Add**</td><td>Inbound voice providers</td><td>Prepends digits to the inbound DID or called number before destination matching.</td><td>`+1`</td></tr><tr><td>**Inbound Number of digits to Remove**</td><td>Inbound voice providers</td><td>Removes leading digits from the inbound DID or called number before adding any inbound prefix.</td><td>`0`</td></tr><tr><td>**DID Modifications**</td><td>Inbound voice providers</td><td>Optional modification rule applied to inbound called numbers before DID matching.</td><td>`Docs US DID Normalize`</td></tr><tr><td>**Same provider IN and OUT**</td><td>Inbound and forwarded voice calls</td><td>Controls whether calls entering from the provider may also be sent out through the same provider.</td><td>`Yes`</td></tr><tr><td>**Allow custom extensions**</td><td>Inbound voice providers</td><td>Allows inbound calls from the provider to match custom extensions. Use only for trusted providers.</td><td>`unchecked`</td></tr><tr><td>**Normalize number**</td><td>Inbound voice providers</td><td>Removes URI or signaling decoration before matching the number to PBX destinations.</td><td>`checked`</td></tr><tr><td>**Get number from**</td><td>Inbound SIP/PJSIP-style signaling</td><td>Chooses where the inbound called number is read from: standard Request-URI, SIP To header, or a fixed value.</td><td>`SIP To: Header`</td></tr><tr><td>**Set to**</td><td>When Get number from is Set to</td><td>Fixed DID or destination number used instead of a number from signaling.</td><td>`+15551239999`</td></tr><tr><td>**Variable name 1-3**</td><td>Inbound voice providers</td><td>Custom inbound channel variable name stored with the `USR-` prefix for routing or dialplan logic.</td><td>`ProviderName`</td></tr><tr><td>**Variable value 1-3**</td><td>Inbound voice providers</td><td>Value assigned to the matching custom inbound channel variable.</td><td>`Docs Telecom SIP Trunk`</td></tr></tbody></table>

## Save, Delete, and Back

<table id="bkmrk-fieldapplies-topurpo-3"><thead><tr><th>Field</th><th>Applies to</th><th>Purpose</th><th>Fictional example</th></tr></thead><tbody><tr><td>**Save**</td><td>All providers</td><td>Stores the provider and creates, updates, or removes realtime account rows as required by the selected technology and Use Realtime Account.</td><td>Save after replacing all fictional values.</td></tr><tr><td>**Delete**</td><td>Existing providers</td><td>Deletes the provider and removes related realtime rows for SIP, PJSIP, or IAX2 providers.</td><td>Delete an unused `Docs Test Provider` after checking routing references.</td></tr><tr><td>**Back**</td><td>All providers</td><td>Returns to the Providers list without submitting the form.</td><td>Use after reviewing settings.</td></tr><tr><td>**Floating Save**</td><td>Long forms</td><td>Lets administrators save from lower sections without scrolling back to the bottom button row.</td><td>Visible while editing realtime account fields.</td></tr></tbody></table>