---
title: "Enhanced Dial Plans"
slug: "8-4-release-enhanced-dial-plans"
updated: 2026-07-23T10:07:21Z
published: 2026-07-23T10:07:21Z
canonical: "help.8x8.com/8-4-release-enhanced-dial-plans"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.8x8.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enhanced Dial Plans

**8x8 Contact Center** dial plans now handle private PBX numbers in addition to full public numbers. New system dial plans are equivalent to prior system dial plans with added support for PBX number dialing. In the new system dial plans, the International Numbering Plan (ITU-T E.164) no longer allows unfiltered pass-through dialing. Dial plans take numbers dialed by users, or numbers originating from other **8x8 Contact Center** components, IVR callback, **web callback**, **click-to-dial**, workplace phone, etc., and apply editing rules to yield one of the following:

- A valid global public phone number (known as E.164)
- A valid PBX number
- A call disallowed message number
- A warning tone generating number

## Features

- Ability to [change the order of the rules](/documentation/docs/8-4-release-enhanced-dial-plans#re-order) by dragging and dropping
- Ability to use private PBX numbers
- Ability to use [](/documentation/docs/8-4-release-enhanced-dial-plans#system-var)[system variables](/documentation/docs/8-4-release-enhanced-dial-plans#system-var) and [user-defined variables](/documentation/docs/8-4-release-enhanced-dial-plans#user-var)
- Dial plan editing results are no longer automatically prefixed with a plus (+) sign

**Built-in system dial plan rules**

A set of new system dial plan rules are designed for **8x8 Work and 8x8 Contact Center** tenants. Users cannot edit the system default dial plans, but they can copy a rule and edit it based on their needs. ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/CM_DialPlans02.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A19%3A10Z&se=2026-11-03T23%3A19%3A10Z&sr=c&sp=r&sig=0sldHXLudtS%2BRXF3KgOiSSeXerX2CoIIvrord4nc%2F3E%3D)

**To copy a system pre-configured rule:**

1. Log in to **8x8 Configuration Manager**.
2. Go to the **Home** page.
3. Go to the **Dial Plans** tab.
4. Click ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/icon-copy.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A19%3A10Z&se=2026-11-03T23%3A19%3A10Z&sr=c&sp=r&sig=0sldHXLudtS%2BRXF3KgOiSSeXerX2CoIIvrord4nc%2F3E%3D) next to a default system rule that you wish to modify. A message appears asking you to click **Save** to keep a copy.
5. Click **OK**. The dial plan creates a copy of the default plan.
6. Enter a new name for the **Dial Plan**.
7. Click **Save**. A copy of the default dial plan is created and added to the list of available dial plans. You can modify the new dial plan according to your tenant needs.

**System variables**

In **8x8 Work and 8x8 Contact Center**, a set of new variables are introduced in dial plan:

| System Variable | Used for |
| --- | --- |
| $PBXID | VOPBX ID/Name |
| $TENANT | Tenant name |
| $AGENTLOGIN | Agent username if available for the call |
| $ORIGNUMBER | Original dialed number |

For example, using $PBXID variable in your dial plan rule allows you to call any extensions in the PBX that has seven digits or less:

| Dialed String Match Pattern | Rewrite Translation | Rule Comment |
| --- | --- | --- |
| ^([0-9]{1,7})*$ | $1-$PBXID | Send 7 digits or less to the host PBX of tenant |

> [!NOTE]
> Note:
> 
> The E.164 system dial plan is no longer a pass-through. A new rule is added to validate the dialing number.

**User variables**

Users can create variables based on their specific needs. For example, a user defines SET MYAREACODE variable below for his area code. When he enters a telephone number, the system dials the area code first and then dials the number.

| Dialed String Match Pattern | Rewrite Translation | Rule Comment |
| --- | --- | --- |
| SET MYAREACODE | 1510 | my area code |
| ^([1-9][0-9][0-9][0-9][0-9][0-9][0-9])$ | $MYAREACODE$1 | add area code |

![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/CM_DialPlans03.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A19%3A10Z&se=2026-11-03T23%3A19%3A10Z&sr=c&sp=r&sig=0sldHXLudtS%2BRXF3KgOiSSeXerX2CoIIvrord4nc%2F3E%3D)

**To see what dial plan rule is currently applied to your tenant**

1. Log in to **8x8 Configuration Manager**.
2. Go to **Home**.
3. Go to the **Dial Plans** tab.
4. Click ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/icon-Pencil_18x18.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A19%3A10Z&se=2026-11-03T23%3A19%3A10Z&sr=c&sp=r&sig=0sldHXLudtS%2BRXF3KgOiSSeXerX2CoIIvrord4nc%2F3E%3D) or **Edit** to open the rules.
5. Enter a number in the **Test Number** text box and click **Test**. A green check mark appears next to the dial plan rule that is applied in your tenant. ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/CM_DialPlans01.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A19%3A10Z&se=2026-11-03T23%3A19%3A10Z&sr=c&sp=r&sig=0sldHXLudtS%2BRXF3KgOiSSeXerX2CoIIvrord4nc%2F3E%3D)

**How do I change the order of my custom rules?**

1. Log in to **8x8 Configuration Manager**.
2. Go to the **Home** page.
3. Go to the **Dial Plans** tab. ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/CM_DialPlans04.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A19%3A10Z&se=2026-11-03T23%3A19%3A10Z&sr=c&sp=r&sig=0sldHXLudtS%2BRXF3KgOiSSeXerX2CoIIvrord4nc%2F3E%3D)
4. Click ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/icon-Pencil_18x18.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A19%3A10Z&se=2026-11-03T23%3A19%3A10Z&sr=c&sp=r&sig=0sldHXLudtS%2BRXF3KgOiSSeXerX2CoIIvrord4nc%2F3E%3D) or **Edit** to open a rule.
5. Click to select the custom rule and drag it to the desired location. ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/CM_DialPlans05.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A19%3A10Z&se=2026-11-03T23%3A19%3A10Z&sr=c&sp=r&sig=0sldHXLudtS%2BRXF3KgOiSSeXerX2CoIIvrord4nc%2F3E%3D)
6. Click **Save**.

> [!NOTE]
> Note:
> 
> You cannot edit system dial plans.

## Backward Compatibility

- All prior dial plans are automatically adjusted to compensate for the plus (+) sign change.
- The original International Numbering Plan (ITU-T E.164) allowed any digit sequence starting with a plus (+) sign to pass through without any digit modifications. The updated equivalent dial plan now includes E.164 number validity checks along with some special and premium number blocking. In some cases, users of this plan may experience a change of behavior if their customary dialing included non-E.164 number patterns.