Settings field descriptions

Last Updated : Apr 17, 2026 |
Prolog information

Settings

Name
Description
Language
Import Language File
Browse and import a language file from your local machine by clicking BrowseImport.
Language file to upload
Specifies the language files to be installed on the phone.
Filenames can be full URL, relative pathname, or filename comma separated filenames ending with .xml. The default value is empty.
Phone Language
Specifies the language used in phone system.
Value format: complete language file name from 0 to 32 characters, for example: Korean.xml.
The default value is empty.
Feature Access
Call Forward
Specifies the status of the Call Forwarding feature.
The options are:
  • Off (default)
  • Unconditional
  • Busy
  • Unconditional and Busy
  • No answer
  • Unconditional and No answer
  • Busy and No answer
  • Unconditional, No answer and Busy
Number of Ring cycle before Call Forward
Specifies the number of ring cycles before the call is forwarded.
The valid value is an integer from 0 to 20. The default number of ring cycles is 1.
Conference continues on host hangup
Specifies whether a conference call continues after the host hangs up.
The options are:
  • Yes
  • No (default)
Presence
Specifies the status of the Presence feature.
The options are:
  • Do Not Allow
  • Allow (default)
Shortcut action Contact
Specifies the shortcut action performed by activating the Contact line during an active call.
The options are:
  • Call to Contact destination (default)
  • Transfer to Contact destination
  • Blind transfer to Contact destination
  • Conference to Contact destination
Shortcut action Autodial
Specifies the shortcut action performed by activating the Autodial line during an active call.
Using Autodial line keys as shortcuts is available only in the Avaya Aura® environment.
The options are:
  • Call to Autodial destination (default)
  • Transfer to Autodial destination
  • Blind transfer to Autodial destination
  • Conference to Autodial destination
Call Decline policy
Specifies whether the user can decline the incoming call. You can enable and disable the feature using the following options:
The options are:
  • Disabled (Default)
  • 486 method: By selecting this value you enable the Call decline policy for the user. 486 method indicates that the call ringing location is not available to take the call.
  • 603 method: By selecting this value you enable the Call decline policy for the user. 603 method indicates that no location is available to take the call.
Keep current CA
Specifies whether the selected line on the phone screen will remain selected if the line is a call appearance with a call that is just ended. The call can be on a primary call appearance, a bridged call appearance or a shared call appearance.
The options are:
  • Disable: select a higher priority call or reset to select the first line if the phone is idle.
  • Enable: keep the current line selection.
The default value is null.
Scrolling mode
Specifies the scrolling mode on the Phone and Feature screens.
The options are:
  • Line scrolling (Default): the user can navigate by using the phone Up and Down navigation keys to select the previous or next line is selected. User can use the left and right navigation keys to select another column in dual screen mode.
  • Page scrolling: the user can use the left and right navigation keys to switch between the previous and next page.
Ignore line key
Specifies if the action of Softkey1 on the phone screen is performed or ignored when the user’s call appearance is on an active call and the user presses the line key associated with the active call.
The options are:
  • Yes (Default): the softkey1 action is ignored
  • No: the softkey1 action is not ignored.
Avaya J129 IP Phone does not support this.
Alerting on calls
Phone Menu Options
Settings
Specifies whether the Settings menu is displayed on the phone.
The options are:
  • Do Not Allow
  • Allow (default)
Network Info Screen
Specifies whether the Network Information screen is displayed on the phone.
The options are:
  • Do Not Allow
  • Allow (default)
SIP User Logout
Specifies whether the Logout feature is provided to the user.
The options are:
  • Do Not Allow
  • Allow (default)
Show SSL Version
Specifies the version of the SSL certificate.
Network Configuration by User
Specifies whether the network configuration can be modified by the user.
The options are:
  • Do Not Allow to Modify
  • Allow to Modify (default)
Call Log
Call Log
Specifies whether to enable or disable the Call Log application on the phone.
The options are:
  • Do Not Allow
  • Allow (default)
Redial Softkey
Specifies whether the Redial soft key is available.
The options are:
  • Do Not Allow
  • Allow (default)
Redial in Phone Menu
Specifies whether phone redials the last number or displays the list of recently dialed numbers.
The options are:
  • Do Not Allow (default)
  • Allow
Redial Softkey Options
Specifies whether to show a list or one number on the Redial soft key.
The options are:
  • List (Redial out of list)
  • One number (default)
Default redial list mode
Specifies that if this parameter is set to Last number redial or Redial list, then it specifies default Redial button action. If this parameter is set to forced, then the Redial Softkey Options parameter will be ignored and the option to pick effect of redial button disappears from Phone UI user menu.
The options are:
  • Last number redial (Default)
  • Redial list
  • Last number redialed Forced
  • Redial list Forced
Log answered elsewhere calls
Specifies the local call log behavior when an incoming call to the phone is answered elsewhere by another user or device.
The options are:
  • As missed call (Default)
  • As answered call
The default value is as missed call.
Contacts
Local Contacts
Specifies whether to enable or disable the Contacts application on the phone.
The options are:
  • Do Not Allow
  • Allow (default)
Contact Name Format
Specifies the format of the contact name to be displayed in the Contacts list.
The options are:
  • 'Last Name' 'First Name' (default)
  • 'First Name' 'Last Name'
Contact Name display logic
Specifies how to match a dialed string on an incoming call with the users contacts.
The options are:
  • Match the number completely (default)
  • Match shorter number completely to the rightmost digits of longer number
  • Match at least 4 rightmost digits
LDAP contacts
Enable LDAP Search
Specifies whether the LDAP Directory feature is enabled on the phone. If LDAP Directory is enabled, users can select it as a contact search source. When LDAP is enabled, other contact search sources become disabled.
The options are:
  • Enabled
  • Disable (Default)
User Name
Specifies an LDAP client user name. The default value is empty.
User Password
Specifies an LDAP client password. The default value is empty.
Server Address
Specifies the IP address or a fully qualified domain name (FQDN) of the LDAP directory server. The valid value is an IPv4 or IPv6 address in the dotted decimal format or a FQDN.
Server Port
Specifies the port number for the LDAP directory server. Valid values are positive integers from 1 to 65535. The default value is 389.
Search Base
Specifies LDAP search base parameters. Valid value is a string of parameter settings, separated by commas. For example, dc=global,dc=avaya,dc=com. The default value is empty.
Protocol
Specifies whether to use TLS or TCP protocol for LDAP.
The options are:
  • Use LDAP
  • Use LDAP+STARTTLS
  • Use LDAPS (Default)
Authentication
Specifies the kind of authentication that is used if the value of the DIRUSERNAME parameter is not null.
Value operation:
Search Attributes
Specifies which LDAP attributes to use in contact search. Valid value is a string of LDAP server search attributes, separated by commas. The default value is cn,sn,telephoneNumber
Display Attributes
Specifies the LDAP attributes the phone returns in a search and the way the phone displays search attributes. Valid value is a string of LDAP search attribute names with corresponding field names, separated with commas.
For example, sn=Last Name,job title=Job,cn=Common Name,o=Office,c=Country. The default value is empty.
Name Attributes
Specifies a primary subset of Search Attributes the phone displays for each match in a search list.
Valid value is a string of LDAP server search attributes, separated by commas. The default value is cn.
Number Attributes
Specifies LDAP fields that contain a callable number. The first number in the sequence becomes the primary number. The valid value is a string of LDAP search attributes which contain a callable number, separated by commas.
For example, telephoneNumber,mobile,DoD SIP URI. The attributes may vary from one LDAP server to another.
Custom directory label
Specifies a custom label to be used for the LDAP directory in the Contacts application. Default label is "LDAP Directory" if this value is not specified.
The valid value is a string. Default value is null.
LDAP to local contact field mapping
Specifies a mapping of LDAP fields to local contact fields. The entire contact mapping is considered invalid if there is no valid rule for either first name or last name or there is no a valid rule for at least one contact number.
The valid value is a string.
The default value is fn=firstName,ln=lastName,cn=nickname,telephoneNumber=work
Emergency Call
Emergency Numbers
Specifies the emergency contact number.
Emergency Softkey
Specifies whether the Emergency soft key is displayed after the phone is registered.
The options are:
  • Do Not Display
  • Display without Confirmation
  • Display with Confirmation (default)
Softkey Emergency Number
Specifies the number(s) which is dialed when the Emergency soft key is pressed.
The valid value is up to 30 dialable characters. The default value is empty.
Value format: digits from 0 to 9, *, #.
Emergency Softkey when logged out
Specifies whether the Emergency soft key is displayed when the phone is not registered.
The options are:
  • Do Not Display
  • Display without Confirmation
  • Display with Confirmation (default)
Phone Lock
Enable Phone Lock
Specifies whether the Lock feature is enabled on the phone.
The options are:
  • Do Not Allow (default)
  • Allow
Note:
If you enable the parameter, the Lock application is available in the Main menu. User can use Phone key customization to present the Lock application in the main phone screen. There is no Lock soft key or feature button.
If you disable the parameter, there is no Lock application. User does not have the option to present the Lock application using Phone key customization in the main phone screen.
Phone Lock Idle Time
Specifies the idle time in minutes after which the phone is locked.
The valid value is an integer from 0 to 10080. The default value is 0 minutes.
Count of PIN/password attempts
Specifies the number of failed attempts that you can permit to unlock the phone. After the user exceeds the permitted limit, the user is blocked from attempting again for a specified time.
The numeric value ranges between 0–20.
If you set the value to 0, the user will not be blocked for the failed attempts to unlock the phone.
Phone PIN/password lock time
Specifies the time period when the user will be blocked from attempting to unlock the phone.
The numeric value ranges between 5–1440 minutes.
The default value is 5 minutes.
Phone Lock PIN
Specifies the PIN that you can set to unlock the phone.
The PIN must be only digits with the value ranging from 4–20 characters.
The default value is null.
Audio
Call Progress Tone Country
AGC Handset
Specifies the Automatic Gain Control setting for the handset.
The options are:
  • Disable
  • Enable (default)
AGC Headset
Specifies the Automatic Gain Control setting for the headset interface.
The options are:
  • Disable
  • Enable (default)
AGC Speaker
Specifies the Automatic Gain Control setting for the speaker.
The options are:
  • Disable
  • Enable (default)
Handset Sidetone Level
Specifies the level of side tone in the handset.
The options are:
  • Normal level (default)
  • Three levels softer than Normal
  • Off
  • One level softer than Normal
  • Two levels softer than Normal
  • Four levels softer than Normal
  • Five levels softer than Normal
  • Six levels softer than Normal
  • One level louder than Normal
  • Two levels louder than Normal
Ringtone Style
Specifies the style of the classic ring tone.
The options are:
  • North America (default)
  • European
Handset Profiles
Specifies an ordered list of names to be displayed for handset audio profile selection.
The list contains audio profiles set in the web interface, the 46xxsettings.txt file and internally, for example: Default,Normal,Amplified,Hearing Aid.
The default value is empty.
Handset Profile Default
Specifies the number of the default handset audio profile.
The options are from 1 to 20. The default value is 1.
Default Acoustic Exposure Protection Mode
Specifies the acoustic exposure protection mode.
The options are:
  • Off (Default)
  • Dynamic
  • 4 hours
  • 8 hours
Dialing
Dial Plan
Specifies the dial plan used in the phone.
Value format: a string of 0 to 1023 characters without any intervening spaces.
The default value is empty.
No Digit Dial Timer
Specifies the time in seconds during which the phone waits for a digit to be dialed after going off-hook and before generating a warning tone.
The valid value is an integer from 0 to 60. The default value is 20 seconds.
Inter-digit Wait Timer
Specifies the time in seconds during which phone waits after a digit is dialed before sending a SIP INVITE.
The valid value is an integer from 0 to 10. The default value is 5 seconds.
Dial Local Area Code
Specifies whether the user must dial the area code of calls within the same area code regions.
The options are:
  • No (default)
  • Yes
Local Area Code
Indicates the phone local area code which allows the user to dial local numbers with more flexibility.
The valid value is a sting of 5 digits ranged from 0 to 9. The default value is empty.
Default dialing mode
Specifies the dialing mode for the user. If this parameter is set to Automatic or Manual, then it specifies default dialing mode. If this parameter is set to forced, then the option to pick dialing mode is not available on the phone UI for the user.
The valid values are:
  • Automatic
  • Manual (Default)
  • Automatic Forced
  • Manual Forced
Enhanced Local Dialing Rules
Enable Local Dialing Rules
Specifies whether the algorithm defined by parameters in this section is used during certain dialing procedures.
The options are:
  • Disable
  • Enable without Contacts (default)
  • Enable with Contacts
Country Code
Specifies the country code of the phone.
The valid value is an integer from 1 to 999. The default value is 1.
International Access Code
Specifies the international access code.
The valid value is up to 4 dialable characters. The default value is 011.
Value format: digits from 0 to 9, *, #.
Long Distance Access Code
Specifies the long distance access code.
The valid value range is a sting of integers from 0 to 9, and empty. The default value is 1.
Internal Extension Number Length
Specifies the length of an internal extension number.
The valid value is an integer from 3 to 13. The default value is 5.
National Telephone Number Length
Specifies the length of a national phone number.
The valid value is an integer from 5 to 15. The default value is 10.
Outside Line Access Code
Specifies the number for making an outside call, i.e. a local call in a public network.
The valid value is up to 2 dialable characters. The default value is 9.
Value format: digits from 0 to 9, *, #.
Remove PSTN access prefix from outgoing number
Allows dialing digits during failover and removing of the PSTN access prefix from the outgoing number.
The options are:
  • No (default)
  • Yes
Admin
Admin Access allowed from Phone
Specifies whether the administrative procedures are used for the phone configuration.
The options are:
  • Yes (default)
  • No
Admin Login fail attempt allowed
Specifies the number of failed attempts to enter the Administration access code before the login is locked.
The options are from 1 to 20. The default value is 10.
Lockout time after failed Admin Login attempt
Specifies the time interval in minutes to re-enter the Administration access code after the login is locked.
The valid value is an integer from 5 to 1440. The default value is 10 minutes.
MLPP
Enable MLPP
Specifies whether the MLPP feature is enabled.
The options are:
  • Disable (default)
  • Enable
Maximum Precedence Level
Specifies the maximal allowed precedence level for the user.
The options are from 1 to 5. The default value is 1.
MLPP Network Domain
Specifies the MLPP Network domain.
The valid values are: empty, “uc” and “dsn”. The default value is empty.
MLPP Precedence Domain
Specifies the MLPP Precedence domain.
The valid values range between 0-9, A-F. The default value is 000000.
Enable Precedence Softkey
Controls whether the Precedence soft key should be displayed on idle line appearances on the phone screen.
The options are:
  • Disable
  • Enable (default)
Guest Login
Guest Login Enable
Specifies whether the Guest Login feature is available on the phone.
The options are:
  • Disable (default)
  • Enable
Guest Login Session Duration (hours)
Specifies the time interval in hours before a guest or a visiting user will be automatically logged off if the telephone is idle.
The valid value is an integer from 1 to 12. The default value is 2 hours.
Guest Login Session Warning Time (minutes)
Specifies the time interval in minutes before a warning of the automatic logoff is initially displayed for a guest or a visiting user.
The valid value is an integer from 1 to 15. The default value is 5 minutes.
Save Extension
Show Last Extension
Specifies whether the extension is displayed after logging out.
The options are:
  • Disable (default)
  • Enable
Bluetooth
Bluetooth Enable
Specifies whether Bluetooth can be enabled in the phone menu.
The options are:
  • Disable
  • Enable (default)
CCMS
Media Preservation
Specifies whether a call will be preserved when there is no SIP connectivity to IP Office.
This setting is applied only in the Avaya Aura® environment.
The options are:
  • Disable
  • Enable (default)
Preserved Call Duration
Specifies the time interval in minutes during which the call is preserved. To apply this setting, Enable IP Office should be set to CCMS and Media Preservation should be enabled.
This setting is applied only in the Avaya Aura® environment.
The valid value is an integer from 10 to 120. The default value is 120 minutes.
Brightness
Primary Display Brightness
Adjusts the brightness of the phone primary display.
The options are from 1 to 5. The default value is 4.
Secondary Display Brightness
Adjusts the brightness of the phone secondary display.
The options are from 1 to 5. The default value is 4.
Button Module #1 Display Brightness
Adjusts the display brightness of the first attached button module.
If no button modules are attached to the phone, this field is disabled.
The options are from 1 to 5. The default value is 4.
Button Module #2 Display Brightness
Adjusts the display brightness of the second attached button module.
If no button modules are attached to the phone, this field is disabled.
The options are from 1 to 5. The default value is 4.
Button Module #3 Display Brightness
Adjusts the display brightness of the third attached button module.
If no button modules are attached to the phone, this field is disabled.
The options are from 1 to 5. The default value is 4.
USB
This option is available only in Avaya J159 IP Phone and Avaya J189 IP Phone
USB Power
Controls USB power when power is provided to the USB interface.
The valid values are:
  • 0-OFF: turn off USB power.
  • 1-ON: turn On USB power only if Aux powered.
  • 2-ON (Default): turn On USB power.
  • 3-ON: turn On USB power if Aux powered or PoE slide switch is set high.
USB Headset
Specifies whether to enable or disable USB Headset.
The valid values are:
  • Enabled (Default)
  • Disabled
USB Keyboard
Specifies whether to enable or disable USB keyboard. It allows to use the keyboard to enter texts.
The valid values are:
  • Enabled (Default)
  • Disabled
USB Stick
Specifies whether to enable or disable USB stick. It allows to copy phone reports to flash drive.
The valid values are:
  • Enabled (Default)
  • Disabled
Privacy
GDPR Mode
Specifies whether the Secure mode is applied on the phone.
The options are:
  • Enable (default)
  • Disable
Downloadable Directory
Downloadable Directory File Name
Enter the directory file name.
The .xml file is the file which has the global directory contacts details and is stored in the file server.
Presence
System DND Link
Specifies one of the following:
  • Activate the SendAllCall feature when the user enables DoNotDisturb presence.
  • Activate DoNotDisturb presence when the user enables the SendAllCall feature.
  • Activate a one-way link between the SendAllCall feature and DoNotDisturb presence.
  • Disable all links.
The options are:
  • No link (Do not activate SendAllCall when user enables DoNotDisturb) (Default)
  • One way link (Activate SendAllCall when user enables DoNotDisturb)
  • Two way link (Activate SendAllCall when user enables DoNotDisturb and vice versa)
  • Forced- No link (Do not activate SendAllCall when user enables DoNotDisturb) (Default)
  • Forced- One way link (Activate SendAllCall when user enables DoNotDisturb)
  • Forced- Two way link (Activate SendAllCall when user enables DoNotDisturb and vice versa)
Avaya Spaces
Spaces Access Mode
Specifies the authentication mode that can be used by the phone when connecting to Avaya Spaces.
The options are:
  • Disabled: all Avaya Spaces features via APIs are disabled.
  • Guest only (Default): Avaya Spaces feature can be accessed by guest/anonymous authentication only.
Connections to Avaya Spaces uses the embedded public certificates and any certificates defined in the TRUSTCERTS. It ignores ENABLE_PUBLIC_CA_CERTS.
Spaces URL
Specifies URL to Avaya Spaces service.
The value starts with http:// or https://. The default scheme is https://. The value length is 0- 255 characters without space.
The default value is https://spaces.avayacloud.com/
Other:
Do not change this parameter unless instructed by Avaya Support.
Spaces API URL
Specifies URL to Avaya Spaces API service.
The value starts with http:// or https://. The default scheme is https://. The value length is 0- 255 characters without space.
Other:
Do not change this parameter unless instructed by Avaya Support.
Spaces Direct Number
You can define a direct number to use when attempting a call to Avaya Spaces. If the user does not select an Avaya Spaces direct number then this defined direct number is used.
The value length is up to 32 characters. Can contain the following: 0 to 9 digits, minus (-), parenthesis (()), plus (+). The default value is Empty.
Spaces Direct Number Menu Item
Specifies if the end user is allowed to select a direct number for a voice call to Avaya Spaces.
The options are:
  • Hide: user is not allowed to select a direct number for a voice call to Avaya Spaces. Any previously selected direct number by the end user is cleared. If Spaces Direct Number is not defined or found to not exist as a valid Direct Number, the user sees an error and warning pop-up on the phone screen.
  • Show (Default): user is allowed to select a direct number for a voice call to Avaya Spaces.
    WLAN_COUNTRY is used to determine the location of the phone. The phone displays phone numbers based on this location. If you set the parameter WLAN_COUNTRY to a country that does not exist in the list of numbers provided by Avaya Spaces, then the phone number of the US is shown.
Other
Softkey Configuration
Specifies which feature will show up on which soft key on the phone screen.
This setting applies only to Avaya J129 IP Phone.
The following numbers are assigned to the features:
  • 0 – Redial
  • 1 – Contacts
  • 2 – Emergency
  • 3 – Recents
  • 4 – Voicemail
Value format: numbers from 0 to 4 and a comma (,).
The default value is “0,1,2”.
Branding Volume
Specifies the volume level at which the Avaya audio brand is played.
The options are:
  • 12db below nominal
  • 9db below nominal
  • 6db below nominal
  • 3db below nominal
  • Nominal (default)
  • 3db above nominal
  • 6db above nominal
  • 9db above nominal
Phone Mute Alert
Specifies whether the Mute Alert feature is blocked.
The options are:
  • Unblocked
  • Blocked (default)
Extend Ringtone
Specifies the audio files to customize the ring tone.
Value format: the list of file names in .xml format separated by commas.
The default value is empty.
Group Number
Specifies group numbers if available.
The valid value is an integer from 0 to 999. The default value is 0.
Minimum delay to backup volume level to PPM
Specifies the minimal time in seconds between backups of the volume levels to the PPM service when the phone is registered to Avaya Aura® Session Manager.
The valid value is an integer from 0 to 900. The default value is 2.
Ignore Contact Header Display Name
Specifies blocking of display name from Contact header.
The options are:
  • Do not ignore (Default)
  • Ignore
Forwarded by order
The "Forwarded by" details are shown for incoming calls that have been forwarded by another user. Specifies which user information to be displayed on an incoming call if there are multiple forwards before being received as an incoming call.
The options are:
  • First Forwarded (Default): First user to have forwarded is shown as the Forwarded By User.
  • Last Forwarded: Last user to have forwarded is shown as the Forwarded By User.
Home Idle Timeout
Specifies that the phone activates the home view if it remains idle for the specified period of time (in minutes)
The options are:
  • Minimum value is 0 , the feature is disabled
  • Maximum value is 30
  • Default value is 10 minutes