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. You can change that number by typing it or by dragging the row to another slot.

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, and every free slot is listed too, so you can see the gaps between keys.

Move buttons by dragging

Grab a row by its drag handle and drop it on another slot. Where you drop it decides what moves:

• On an empty slot: only that key moves. The slot it came from is left empty.
• On another key in the same unbroken run of keys: the run reorders like a list. The keys in between slide over one slot to fill the space, and nothing outside the run moves.
• On a key across a gap: the key takes that slot, and the keys below it in that run shift down one slot into the gap that follows. The slot it came from is left empty.

Gaps you leave on purpose stay where they are: a drag never packs the list together. While you drag, the rows that would shift are highlighted. A long stretch of empty slots is folded into one row; hover over it while dragging, or select it, to open it.

You can also drag with the keyboard: focus a row’s drag handle, press Space to pick the key up, use the Up and Down arrows to move between slots, and press Space again to drop it. Escape cancels the drag and leaves the phone editor open with your other changes intact.

Dragging changes the layout only in the editor. Select Save to keep it, or close the editor without saving to discard it. Typing a new Key # still works and never shifts other keys.

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:

A divider marks where each page of the module starts. A drag can push a key across a divider onto the next page, so check the dividers after a large move.

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.
• A key will not drop where you want it: Dropping on a key across a gap needs an empty slot below that run to shift into. When the run already reaches the last slot, drop on an empty slot instead, or remove a key first. While any row has a duplicate, missing, or out-of-range key number, a key can only be dropped on an empty slot. Fix the highlighted numbers to drag freely again.
• 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.