Digit mapping

Last Updated : Aug 28, 2026 |
Prolog information
Metadata
Keywords:
You can configure digit maps for the phone. This configuration completely replaces the use of the DIALPLAN parameter and Enhanced Local Dialing (ELD) to provide both a dial plan and dialing rules at the same time.
Using this feature, you can enable the following:
  • Matching rules which trigger a matching dial plan
  • Substitution rules to provide the same functions as ELD, such as prefix insertion and removal, addition of area codes and country codes.
This feature also enables the phone to block certain numbers from being dialed by users.
You can configure digital maps through the 46xxsettings.txt file with the help of SET and ADD operators, which allows to use several digit maps. There is no set limit to the quantity of rules in a single digit map string, but a character limit of 255 characters for each string in a parameter value applies. You can also configure this feature using the web interface, which is the preferred way of configuration.
A digit map is a group of one or several rules, separated by commas (,). You can use blank spaces in digit maps for better readability, the phone ignores them when reading a digit map.
If a user dials a sequence that matches two or more rules in a digit map, the phone uses the exactly or most closely matching rule for that sequence.

Digit mapping syntax

You can use the following elements to configure digit maps:
Element sign
Element name
Element description
Rule example
Any combination of: 0-9 * # + - A-Z a-z, excluding: x
Literals
Matches digit sequences with exactly the same literals. Use literals to explicitly match a string.
To explicitly match the phone number 1-212-555-7722, create the following rule from literals:
  • 12125557722
  • 1 212 555 7722
You can add spaces for readability.
Example:
SET DIGIT_MAPPING "12125557722,12125557724"
to precisely match these phone numbers
x
x
A wildcard element. Can stand for any character.
To create a rule for any 11 digit number started with 8831, use the following rule:
  • 8831 xxx xxxx
.
.Matching Function
A matching function matches 0 or more of the previous element, such as x. You can use it to capture a string of entered numbers or characters of arbitrary length.
To create a rule to use Australian international dialing notation, use the following rule:
  • 0011 64 x.
[  ]
Set
You can enclose a set of characters to match them to a single digit or character. You can use a set to match specific digits that form part of a number. Alphanumeric and wildcard characters are allowed inside a set, such as [x], [x#], [@#]..
The following set: [125-8]  matches the numbers 1,2,5,6,7 and 8
[^  ]
Exclusion Set
An exclusion set matches any single alphanumeric character that is not within the set.
To match any arbitrarily long sequence of digits that does not start with 6,7,8,9, use the following matching rule:
  • [^6-9]x.
!
! Call Bar
To bar users from calling numbers that match a rule, add an exclamation mark (!) in front of that rule in the digit map. 
To bar all calls to numbers starting with 1900, regardless of length, use the following rule:
  • !1900x.
< elements : literals >
Element to Literal Transformation
Enables replacing of numerals and/or characters sequence matching elements with given literals. The expression is contained within a set of pointy brackets (< >) -and elements are separated from literals using a colon (:).
Use this rule to remove digits from a dialed number, add digits to a dialed number, or transform a dialed number. You cannot use single quote ‘ ‘ for the literals in this context. You can use special character as they do not apply in this context either. Elements can be empty, in which case you can omit the colon (:).
The literals part can be empty too, but the colon (:) must not be omitted in this case. Both elements and literals cannot be empty at the same time.
  • <112:000>  - Take 112 and replace it with 000.
  • <02:>xxxx xxxx - Take 02, replace it with nothing, then match the next 8 digits.
  • <02>xxxx xxxx   or  <:02>xxxx xxxx - Add 02 to the start of an 8-digit number
Related links
Feature and application configuration
Digit mapping parameters
Digit mapping parameters