Yealink - Common Overrides

This article lists common overrides you can configure for Yealink handsets.

This article is not a comprehensive list of all available overrides for Yealinks, for full documentation see here: Yealink Documentation

Null Values

You can override any provisioned value by entering %NULL%

firmware.url.server_type="%NULL%"

Set Static IP Address

First, set this config to enable Static IP mode ("0" is DHCP, "2" is Static IP)

static.network.internet_port.type="2"

Then the below lets you configure a static IP address on the phone.

static.network.internet_port.ip="192.168.1.152"
static.network.internet_port.mask"255.255.255.0"
static.network.internet_port.gateway"192.168.1.1"

static.network.ip_address_mode="1"
static.network.ipv6_internet_port.type="1"
static.network.ipv6_internet_port.ip="<IPv6 IP address>"
static.network.ipv6_internet_port.gateway="<IPv6 Gateway>"

Set Custom Static DNS

The below lets you set a custom value for the phone's DNS servers, by default we use 1.1.1.1 for the primary, and 8.8.8.8 for the secondary.

static.network.primary_dns="1.1.1.1"
static.network.secondary_dns="8.8.8.8"

Use the below disable static DNS.

static.network.static_dns_enable="0"

static.network.ipv6_static_dns_enable="1"
static.network.ipv6_primary_dns="<primary address>"
static.network.ipv6_secondary_dns"<secondary address>"

Speed Dial to Voicemail Without Entering PIN

features.enhanced_dss_keys.enable="1"
linekey.X.type="73"
linekey.X.line="1"
linekey.X.label="Speeddial VM"
linekey.X.value="9900,Extension,,,PIN#"

(Replace 'X' with the number of the BLF key you are setting) The overrides above will let you have a BLF key as a Speed dial to dial into a voicemail box without entering a PIN 

Example: Extension 101 has 1234 PIN, the override will look like this:

linekey.10.value="9900,101,,,1234#"

Change Admin Password

The below will let you set what the admin password for the phone is, this is used to made advanced changes or log into the phone's web GUI.

security.user_password="admin:<New Password Here>"

Force Reboot on Resync

By default, resyncing a Yealink will cause it to pull its config without rebooting, you can use the below to force it to reboot on resync.

sip.notify_reboot_enable="1"

Enable/Disable Web GUI

Enable or Disable access to the Web GUI via the Phone's IP address. By Default HTTP is disabled and HTTPS is enabled.

"0" for Disabled, "1" for Enabled

wui.http_enable="1"
wui.https_enable="1"
static.wui.http_enable="1"
static.wui.https_enable="1"

Call Transfer Type

Use "0" for Blind Transfer, and "1" for Attended Transfer (Default value is 1)

transfer.dsskey_deal_type="1"

Yealink Override Key Types

When programming a Yealink phone, the required settings will depend on which key is involved. There are 4 keys: Memory Key, Line Key, Programmable Key, and Expansion Module Key.

Memory Key

This is a physical key that is not located next to a screen, such as the side buttons on a Yealink T28P.
(Replace 'X' with the number of the key you are setting).

memorykey.X.line=
memorykey.X.value=
memorykey.X.pickup_value=
memorykey.X.type=
memorykey.X.xml_phonebook=

See Common Yealink Override Examples further below in this document.

Line Key

This is a BLF Key located on either side of a screen.
(Replace 'X' with the number of the key you are setting).

linekey.X.line=
linekey.X.value=
linekey.X.pickup_value=
linekey.X.type=
linekey.X.xml_phonebook=
linekey.X.label=

See Common Yealink Override Examples further below in this document

Programmable Key

These are physical buttons, refer to Yealink's website for more information.
(Replace 'X' with the number of the key you are setting).

programablekey.X.type=
programablekey.X.line=
programablekey.X.value=
programablekey.X.xml_phonebook=
programablekey.X.history_type=
programablekey.X.label=

See Common Yealink Override Examples further below in this document

Expansion Module Key

These are keys located on Expansion Modules (side cars).
(Replace 'X' with the expansion module number, and Y with the number of the key you are setting).

expansion_module.X.key.Y.type=
expansion_module.X.key.Y.line=
expansion_module.X.key.Y.value=
expansion_module.X.key.Y.pickup_value=
expansion_module.X.key.Y.label=
expansion_module.X.key.Y.xml_phonebook=

See Common Yealink Override Examples further below in this document. 

linekey.X.type = "Y"
linekey.X.value = "(this may vary, depending on the key type, but usually is an Extension)"
linekey.X.label = "Label"

DSS Key Length

This setting makes the labels next to line keys full length so that it is not cut off.

0=Default, 1=Extended

features.config_dsskey_length="1"

Next Page Key

Set to "0" to disable the next page key. By default "1" is configured.

features.keep_switch_page_key.enable="0"

Ringer Volume

It is sometimes necessary to lock the ringer volume at the administrative level. This can be done by setting the below value to 0 through 15, with 15 being the loudest. If any value is set, the rocker switch will not work. You can set this value to blank in order to restore volume rocker functionality.

force.voice.ring_vol="10"

Dial Plans

The first three Dial Now rules are in used by the generic config file and are shown below.

dialplan.dialnow.rule.1="44xxxxxxxxxx"
dialplan.dialnow.rule.2="0[2-9]xxxxxxxxxx"
dialplan.dialnow.rule.3="999"

You can add additional dial now rules for faster extension dialing, as well as dial block rules.

dialplan.dialnow.rule.4=
dialplan.dialnow.rule.5=
dialplan.dialnow.rule.6=
dialplan.dialnow.rule.7=
dialplan.dialnow.rule.8=
dialplan.dialnow.rule.9=
dialplan.dialnow.rule.10=
dialplan.block_out.number.1 =
dialplan.block_out.number.2 =
dialplan.block_out.number.3 =
dialplan.block_out.number.4 =
dialplan.block_out.number.5 =
dialplan.block_out.number.6 =
dialplan.block_out.number.7 =
dialplan.block_out.number.8 =
dialplan.block_out.number.9 =
dialplan.block_out.number.10 =

Allow Remote Control From IPs

features.action_uri_limit_ip="any"

or

features.action_uri_limit_ip="192.168.0.1"

Directed Call Pickup

Directed call pickup is used for picking up an incoming call on a specific extension. A user can pick up the incoming call using a directed pickup key.

linekey.x.extension="*8"

where x is the dss key number

Multicast Paging

See here for multicast paging.

Background Idle Image

The following override will set a custom background image.

In this example, the file name of the image is phone.png - replace this with your actual file name in both lines of overrides.

phone_setting.backgrounds="Config:phone.png"
wallpaper_upload.url="http://yourdomain.com/phone.png"

Image sizes:  Different model phones will only work with certain size images. Please refer to the manufacture's information for more specific information. 

Multiple Keys per Line

The following override will show the same line appearance that is programmed for Line 1 on the second programmable button (ie. linekey 2).

linekey.2.line="1"
linekey.2.type="15"
linekey.2.label="1000"

The tells the phone to use 'line' 1, type 15 is a Line Key Type, and to label the Line Key '1000'.

Increase Time Out for Dial Now Rule

By default, if you dial anything at all Yealink phones will wait 4 seconds for any more inputs, if no new input is entered then the phone will dial whatever is currently input. You can use the below override to change this delay.

phone_setting.dialnow_delay="x"

Do Not Disturb - Feature Sync

You can use the following overrides with the Yealink phone to sync the DND feature button with the NDP

features.dnd.on_code="*78"
features.dnd.off_code="*79"

Daylight Savings Time

0 = Disabled 1 = Enabled 2= Automatic

local_time.summer_time="0"

Time Format

0 = 12- Hour Format     1 = 24- Hour Format

local_time.time_format="0"

Mute the Microphone for Intercom Privacy

You can set privacy on your intercom to force the receiving party to un-mute their phone in order to begin talking, instead of answer & listen hands-free.

features.intercom.mute="1"

Enable Missed Call Logs

account.1.missed_calllog="1"

Disable Do Not Disturb

To disable the DND button, use the following override. Once enabled, users will not be able to activate or configure DND on the device.

features.dnd.allow=“0”

Disable Video (T49G/T58V)

Video can cause issues on some phones or carriers accepting the SIP Invite. To disable the video, you can use the following Override.

video.enable="0"

You can also make video an option, by setting this to 2. The phone will prompt for audio or video when placing or receiving calls.

video.enable="2"

Jitter Buffer to Fixed

A jitter buffer helps to even out that jitter to improve audio quality for the recipient. It delays and stores incoming data packets before sending them on to the recipient. The delay is normally imperceptible—less than a second. But adding a tiny delay helps to smooth out the audio and give them a better experience.

By default the phone attempts to dynamically set the jitter buffer, however in some circumstances  you may want to set it manually to help with audio problems.

voice.jib.adaptive="1"
voice.jib.min="120"
voice.jib.max="120"
voice.jib.normal="120"

SIP Scanner Protection

Blocks any invites from any location but the registered SIP server.

features.direct_ip_call_enable="0"
sip.trust_ctrl="1"
sip_trust_ctrl="1" (only for Firmware under v80)

Installing Applications on Android Yealink Phones(T56/T58/CP960)

Installing Applications can only be done via auto-provisioning. There is no way to install applications from the WebUI.

To install an APK you must host the File on a web server.  Once you have the file on a local or public http server you can use the following overrides.

Install App

app.install_url="http://webaddress/appname.apk"

Uninstall App

app.uninstall="appname.apk"

Update Auto Answer Tone

Please see the following guide for different tones you can set: https://support.yealink.com/en/portal/knowledge/show?id=d78743e1aeb7fc964a6f93bd

voice.tone.autoanswer="1400/500,0/15000"

Increase HTTP/HTTPS File Transfer Timeout

Can be used if provisioning is taking longer than the default timeout.

network.attempt_expired_time="<seconds>"

App Permissions

If you install a trusted application, and it is unable to fully function due to Android OS Permissions, you can use the following override.

pm.check_permission="none"

The default value for permissions is "standard". This override should be applied at the time that you install the app.

Personalize your Display

account.1.label="ADD YOUR NAME"
account.1.display_name="ADD YOUR NAME"

Line Appearance Key in on button 1

linekey.1.type="15"
linekey.1.line="1"
linekey.1.label="Line 1"

BLF (Busy Lamp Field) key on button 2

linekey.2.type="16"
linekey.2.line="1"
linekey.2.label="Jenny"
linekey.2.value="101"

Speed Dial key on button 3

linekey.3.type="13"
linekey.3.line="1"
linekey.3.label="Jenny Cell"
linekey.3.value="8008675309"

Call Park with ringback on button 4

linekey.4.type="10"
linekey.4.line="1"
linekey.4.label="Call Park"
linekey.4.value="721"

Headset Ringing

When using a headset you can set your option of where you want your phone to ring (Speaker, Headset, or both.

(0 is speaker, 1 is headset, 2 is headset and speaker)

work.features.ringer_device.is_use_headset="2"

Transfer on Conference Hang up

It's possible to transfer a local conference call to the remaining participants of a call, so they may continue even after the host drops out.

This feature is disabled by default. The override shown below will enable the feature, "0" is used to disable it.

transfer.tran_others_after_conf_enable="1"

Acoustic Echo Cancellation and Noise Suppression

By default, these features are enabled. The overrides shown below will disable the features; setting them to "1" will enable the features.

To disable the Acoustic Echo Cancellation (AEC) feature, use the following override:

voice.echo_cancellation="0"

To disable the Noise Suppression feature, use the following override:

voice.tns.enable="0"