Soft Key Parameters

You can create up to 10 custom soft keys.

If you configure more soft keys than what can fit on the phone's screen, a More soft key displays. Users can use the More soft key to display any additional soft keys available.

If you want the phone to display both default and custom soft keys, you can configure them in any order. However, the order in which soft keys display depends on the phone's menu level and call state. If you have configured custom soft keys to display with the default soft keys, the order of the soft keys may change.

Note: The Hold, Transfer, and Conference soft keys are grouped together to avoid usability issues. You may experience errors if you try to insert a soft key between these three grouped soft keys.

The following table shows you the parameters for configuring soft keys. Note that this feature is part of enhanced feature keys (EFK), and you must enable the EFK parameters to configure soft keys. See the Enhanced Feature Keys section for details about configuring soft keys and line keys.

Table 1. Configure Soft Keys

Template

Parameter

Permitted Values

Change Causes Restart or Reboot

features.cfg

feature.enhancedFeatureKeys.enabled

0 (default) - Disables the enhanced feature keys feature.

1 - Enables the enhanced feature keys feature.

No

features.cfg

softkey.x.action

Controls the action or function for the custom soft key x.

Null (default)

macro action string, 2048 characters

This value uses the same macro action string syntax as an Enhanced Feature Key.

No

features.cfg

softkey.x.enable

0 (default) - The x soft key is disabled.

1 - The x soft key is enabled.

No

features.cfg

softkey.x.insert

0 (default) - The phone places the soft key in the first available position.

0 to 10 - The phone places the soft key in the corresponding position and moves the following soft keys by one position to the right.

For example, if the soft key is set to 3, the soft key is displayed in the third position from the left. If the soft key already exists in the third position, it is moved to fourth position and the following soft keys are moved to right by one space.

If softkey.x.precede is configured, this value is ignored. If the insert location is greater than the number of soft keys, the key is positioned last after the other soft keys.

No

features.cfg

softkey.x.label

The text displayed on the soft key label. If Null, the label is determined as follows:
  • If the soft key performs an Enhanced Feature Key macro action, the label of the macro defined using efk.efklist is used.
  • If the soft key calls a speed dial, the label of the speed dial contact is used.
  • If the soft key performs chained actions, the label of the first action is used.
  • If the soft key label is Null and none of the preceding criteria are matched, the label is blank.

Null (default)

String

Note that the maximum number of characters for this parameter value is 16; however, the maximum number of characters that a phone can display on its user interface varies by phone model and by the width of the characters used. Parameter values that exceed the phone's maximum display length are truncated by ellipses (…). The phone truncates the beginning of numerical labels (for example, …4567) and truncates the end of alphabetical labels (for example, Abcd…).

No

features.cfg

softkey.x.precede

0 (default) - The phone locates the soft key in the first available position from left.

1 - The phone locates the soft key before the default soft key position.

No

features.cfg

softkey.x.use

Specify which call states the soft key displays in.

features.cfg

softkey.x.use.active

0 (default) - Does not display the soft key x during an active call.

1 - Displays the soft key x during an active call.

No

features.cfg

softkey.x.use.alerting

0 (default) - Does not display the soft key x in an alerting state during an active call.

1 - Displays the soft key x in an alerting state during an active call.

No

features.cfg

softkey.x.use.dialtone

0 (default) - Does not display the soft key in the dial tone state during an active call.

1 - Displays the soft key x in the dial tone state during an active call.

No

features.cfg

softkey.x.use.hold

0 (default) - Does not display the soft key x in the hold state during an active call.

1 - Displays the soft key x in the hold state during an active call.

No

features.cfg

softkey.x.use.idle

0 (default) - Does not display the soft key x in the idle state during an active call.

1 - Displays the soft key x in the idle state during an active call.

No

features.cfg

softkey.x.use.park

0 (default) - Does not display the soft key x in the parked state during an active call.

1 - Displays the soft key x in the parked state during an active call.

No

features.cfg

softkey.x.use.proceeding

0 (default) - Does not display the soft key x in the proceeding state during an active call.

1 - Displays the soft key x in the proceeding state during an active call.

No

features.cfg

softkey.x.use.setup

0 (default) - Does not display the soft key x in the setup state during an active call.

1 - Displays the soft key x in the setup state during an active call.

No

features.cfg

softkey.feature.intercom

1 (default) - Enables the Intercom soft key.

0 - Disables the Intercom soft key.

No

features.cfg

softkey.feature.doNotDisturb

1 (default) - Enables the DND soft key on the phone.

0 - Disables the DND soft key on the phone.

features.cfg

softkey.feature.basicCallManagement.redundant

1 (default) - Displays the Hold, Transfer, and Conference soft keys.

0 - Does not display the Hold, Transfer, and Conference soft keys.

No

features.cfg

softkey.feature.buddies

1 (default) - Displays the Buddies soft key.

0 - Does not display the Buddies soft key.

No

features.cfg

softkey.feature.callers

0 (default) - Displays the Callers soft key for all platforms.

1 - Does not display the Callers soft key for all platforms.

No

features.cfg

softkey.feature.directories

1 (default) - Displays the Directories (Dir) soft key.

0 - Does not display the Directories (Dir) soft key.

Yes

features.cfg

softkey.feature.doNotDisturb

1 (default) - Enables the DND soft key.

0 - Disables the DND soft key.

No

features.cfg

softkey.feature.endcall

1 (default) - Displays the End Call soft key.

0 - Does not display the End Call soft key.

No

features.cfg

softkey.feature.forward

1 (default) - Displays the Forward soft key.

0 - Does not display the Forward soft key.

No

features.cfg

softkey.feature.join

1 (default) - Displays the Join soft key.

0 - Does not display the Join soft key.

No

features.cfg

softkey.feature.mystatus

1 (default) - Displays the MyStatus soft key (if pres.idleSoftKeys is set to 1).

0 - Does not display the MyStatus soft key.

No

features.cfg

softkey.feature.newcall

1 (default) - Displays the New Call soft key is displayed.

0 - Does not display the New Call soft key.

No

features.cfg

softkey.feature.redial

0 (default) - Displays the Redial soft key.

1 - Does not display the Redial soft key.

The parameter feature.enhancedFeatureKeys.enabled must be set to 1 first to configure this feature, and the parameter efk.softkey.alignleft must be set to 1 to move enabled soft keys into the positions of disabled soft keys.

No

features.cfg

softkey.feature.split

1 (default) - Displays the Split soft key to split the conference call to individual calls.

0 - Does not display the Split soft key.

No