Program phone buttons, BLF, and expansion modules

Assign functions to a desk phone's programmable keys, monitored-extension lamps, expansion module slots, and on-screen SoftKeys.

A desk phone’s programmable keys are configured from the Buttons tab of the phone editor, not on the handset itself. Depending on the model, the tab holds up to three independent lists: the programmable buttons on the phone body, the buttons on an attached expansion module, and the four on-screen SoftKeys below the display.

Each list is saved as a whole. The Key # on a row is the physical button it lands on, so the number — not the order rows appear in — decides where a function ends up on the phone.

Prerequisites

• Phone write access, and a phone already present in the Phones list.
• The extensions and call groups you plan to reference. A monitored-extension key needs an existing extension, and a call-group voicemail key needs a call group that has an extension number.
• Physical access to the phone if you need to reboot it after the change.

What you can put on a button

Every key takes an optional label of up to 32 characters — what the phone prints beside the button — and a short label of up to 16 characters for the phone’s compact display. The monitored-extension picker deliberately leaves out the phone’s own extension; a Line key can point at any extension including its own.

Program a button on the phone body

1. Open Settings, expand Call Setup, and select Phones.
2. Select Edit on the phone’s card, then open the Buttons tab.
3. Select + Add Button. A new row appears in the lowest free slot.
4. Set Key # to the physical button you want. A phone body holds up to 27 programmable buttons, and the counter beside the section heading shows how many are used.
5. Choose the function, type a label, and fill in whatever that function needs — a speed-dial number, an extension to monitor, a park slot, or a call group.
6. Select Save, then push the configuration to the phone.

To retire a key, remove its row and save. Rows are listed in key-number order regardless of when you added them.

Program expansion module buttons

An Expansion Module Buttons section appears only on models that host a sidecar module. The module type sets how many slots you can fill and how they map to the module’s pages:

Module keys use the same function list as the phone body, but have no short label. They take effect only while the module is physically connected — a saved layout on a phone with no module attached simply does nothing until one is.

After changing module keys, push the configuration with a reboot so the monitored-extension lamps reconnect.

Program the four SoftKeys

The SoftKeys (below screen) section covers the four keys under the display on a Yealink desk phone. Cordless bases and handsets and conference-room models have none, so the section is absent for them.

1. Select + Add SoftKey and pick the slot, 1 through 4.
2. Choose a function: Speed Dial, History, Menu, DND, Paging, or Directory.
3. Speed Dial needs both a number and a label. Paging takes an optional label. The rest need nothing else.
4. Save, then push the configuration.

Any SoftKey you do not set keeps the phone’s factory default — 1 History, 2 Directory, 3 DND, 4 Menu — so removing a SoftKey row reverts that key to its default rather than blanking it. SoftKey changes do not reach a phone that Steer Phones has placed on a custom provisioning configuration.

Deliver the change to the phone

Saving stores the layout; it does not move it onto the handset. Use Push Config on the phone’s card afterwards, or wait for the phone’s next provisioning cycle.

Choose Push Config & Reboot whenever you changed a monitored-extension (BLF) key, a line key, or an expansion module key. A plain push reloads the configuration, but the phone only re-establishes the subscriptions behind those lamps after a restart — which is why a lamp that never lights is almost always a push that skipped the reboot.

As a safety net, the platform re-checks a phone’s subscriptions when it registers and can send it a re-provisioning reboot on its own. That recovers a missed reboot eventually; it is not a reason to skip one.

Phones that share an extension

Several phones can answer the same extension — a desk phone plus a softphone, a cordless base plus its handsets, or the same extension at two desks. Each of those devices keeps its own button layout, so a change on one does not appear on the others. Program each device you want the buttons on.

Expected result

The Buttons tab lists each key with its number, function, and label; saving reports the phone as updated; and after a push the physical keys carry the labels and functions you set, with monitored extensions lamping as their extensions go in and out of use.

Troubleshooting

• A save reports that a button key is incomplete: The named row is missing a required value — a speed-dial number or label, an extension to monitor, a park slot, or a call group. The Buttons tab highlights the row.
• A save reports a missing, out-of-range, or duplicate key number: Every row needs its own number inside the range for that section — 1 to 27 on the phone body, or the module’s slot range. Fix the highlighted rows and save again.
• Add Button is disabled: That section is full. Remove a key before adding another.
• The monitored-extension picker says no extensions are available: The phone’s own extension is never offered. Create or free another extension to monitor.
• The call-group picker is empty: Only call groups that have an extension number can be selected. Give the group a number first.
• The Buttons tab reports that extensions and call groups could not be loaded: The button editor is unavailable until the page reloads, but the Details tab still saves and your existing buttons are left untouched.
• A monitored-extension lamp stays dark: Push the configuration again with a reboot. If it is still dark after the phone restarts, confirm the key points at the extension you meant.
• There is no expansion or SoftKeys section: That model does not host an expansion module, or is not a Yealink desk phone. The editor only shows controls the device can actually use.

Related guidance

• Manage provisioned phones.
• Set up softphones, cordless handsets, and speakers.
• Create and manage extensions.
• Create call groups and call menus.
• Manage the shared contact directory.
• Check and manage voicemail from a phone.