--- title: "Create custom dial plans" slug: "create-custom-dial-plans" updated: 2026-07-23T10:07:36Z published: 2026-07-23T10:07:36Z canonical: "help.8x8.com/create-custom-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. # Create custom dial plans Creating a custom dial plan in **8x8 Contact Center** requires a good understanding of regular expressions. This section gives a brief overview of creating a custom plan. You may seek guidance from professional services for creating a custom plan from scratch. To create a custom dial plan via **8x8 Configuration Manager**: 1. Log in to **8x8 Configuration Manager**. 2. From the **Configuration Menu**, open **Home**. 3. Go to the **Dial Plans** tab. 4. Click ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/icon_plus_18x18.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A56%3A39Z&se=2026-11-03T23%3A56%3A39Z&sr=c&sp=r&sig=r4uuh2wjhynUecY95%2BxaXmbjibuf0ULK9UOnmy0tmtY%3D) to add a new dial plan. ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/cfgmgrhomedialplan05.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A56%3A39Z&se=2026-11-03T23%3A56%3A39Z&sr=c&sp=r&sig=r4uuh2wjhynUecY95%2BxaXmbjibuf0ULK9UOnmy0tmtY%3D) 5. In the **Add New Dial Plan** window, enter the following information: | Dial Plans | Description | | --- | --- | | Dial Plan Name | Enter a name for the new dial plan. | | Test Number | Enter a telephone number to test your plan. A![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/icon-check_18x18.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A56%3A39Z&se=2026-11-03T23%3A56%3A39Z&sr=c&sp=r&sig=r4uuh2wjhynUecY95%2BxaXmbjibuf0ULK9UOnmy0tmtY%3D) indicates which rule is being applied. | | Default Plan | Check the option to mark this as the default dial plan. | | Order | Indicates the order of the rules applied to each number. You can change the order of the rules in custom plans by dragging and dropping them in the desired location. | | Dialed String Match Pattern | Define a calling number pattern to apply the dial plan using regular expressions. A regular expression provides a concise and flexible means for matching strings of text, or patterns of characters. Most commonly used regular expressions are: **^** - Matches the starting position of the string. **.** - Matches any single character. ***** - Matches the preceding element 0 or more times. **$** - Matches the ending position of the string. **[ ]** - Matches a single character contained within the brackets. For example, [2-9] specifies any digit from 2 through 9. **( )** - A marked sub-expression within which you define a string to match. For example, the pattern ^([2-9][0-9][0-9][0-9][0-9][0-9][0-9])$ defines a 7-digit sequence where the first digit is not 0 or 1. > [!NOTE] > Note: > > Defining a dial plan requires sound knowledge of regular expressions. | | Rewrite Translation | Define the treatment for the number that matches the specified calling number pattern. For example, the pattern ^([2-9][0-9][0-9][0-9][0-9][0-9][0-9])$ and treatment 1650$1 prepends a 7-digit input with "1650". $1 represents pattern within the (). If you input 5551212, the treatment converts the number to 16505551212. | | Rule Comment | Gives a brief description of the treatment received by the rule. | | Delete Rule | Allows you to delete the rule. This applies to user-defined rules only. | | Test Match | Indicates if the rule applies to the test number. | 6. Click ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/icon_plus_18x18.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A56%3A39Z&se=2026-11-03T23%3A56%3A39Z&sr=c&sp=r&sig=r4uuh2wjhynUecY95%2BxaXmbjibuf0ULK9UOnmy0tmtY%3D) to add a new rule. Click ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/icon_delete_18x18.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A56%3A39Z&se=2026-11-03T23%3A56%3A39Z&sr=c&sp=r&sig=r4uuh2wjhynUecY95%2BxaXmbjibuf0ULK9UOnmy0tmtY%3D) to delete a rule. Examples of dial plan rules shown above can be interpreted as follows: 1. The pattern ^([2-9][0-9][0-9][0-9][0-9][0-9][0-9])$ and treatment 1650$1 converts a 7 digit input to 10 digits. For example, if you input 5551212, the number gets prefixed with the area code and converts to 16505551212. 2. The pattern ^(55[0-9][0-9])$ and treatment 1650292$1 converts all 4 digit extension number starting with 55 to 165029255XX, where X is a mandatory single digit. 7. Enter a sequence of digits and click **Test** to validate the calling number pattern and treatment you defined. The first matched rule shows ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/icon-check_18x18.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A56%3A39Z&se=2026-11-03T23%3A56%3A39Z&sr=c&sp=r&sig=r4uuh2wjhynUecY95%2BxaXmbjibuf0ULK9UOnmy0tmtY%3D) to indicate a match. 8. Click **Save**. ## Variables We have two types of variables in dial plans: **System variables** The following set of new variables are introduced in dial plan. The system variables cannot be edited. | System Variable | Used for | | --- | --- | | $TENANT | Tenant name | | $AGENTLOGIN | Agent username, if available for the call | | $ORIGNUMBER | Original dialed number | > [!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-Defined variables** Users can create variables based on their specific needs. For example, a user defines the variable SET MYAREACODE for their area code. When they enter 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 | **Change the order of custom rules** 1. From the **Configuration Menu**, open **Home**. 2. Go to the **Dial Plans** tab. 3. Click ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/icon_edit_18x18.png?sv=2026-02-06&spr=https&st=2026-11-03T22%3A56%3A39Z&se=2026-11-03T23%3A56%3A39Z&sr=c&sp=r&sig=r4uuh2wjhynUecY95%2BxaXmbjibuf0ULK9UOnmy0tmtY%3D) or **Edit** to open a rule. 4. 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%3A56%3A39Z&se=2026-11-03T23%3A56%3A39Z&sr=c&sp=r&sig=r4uuh2wjhynUecY95%2BxaXmbjibuf0ULK9UOnmy0tmtY%3D) 5. Click **Save**. > [!NOTE] > Note: > > You cannot edit system dial plans.