Guide · Extensions

Extensions: All the Settings and What Each One Does

An extension is one phone line in the account. In this guide we go through all of its settings, one by one: what an extension is, what happens when no one answers, the difference between "Do Not Disturb" and immediate forwarding, what the person you call sees, and what each advanced field does. You do not need to read everything. You can jump straight to the setting you are looking for.

1

What is an extension

An extension is one phone line in your account on the PBX. It is not a device, and not a person. It is a line. A device is registered on this line: a desk phone connected to the internet, an app on a mobile or a computer, or a SIM from the PBX. You dial out from the line, and calls come to the line, either directly or through an IVR menu, queue or hunt group.

This separation matters, because several things follow from it that are surprising at first:

  • An extension has settings even when no device is connected to it. The settings live on the line, not on the device.
  • You can replace a device without touching any setting. The line stays the same line.
  • If no device is connected, a call that reaches the extension does not ring at all. It goes immediately to the "Unavailable" destination (more on this in step 4).

Every extension has a line name, its identifier in the PBX, which cannot be changed. Next to it is a name that you set, such as "David, Administration". The name you set is what appears everywhere in the control panel.

A new extension is created from the "New Extension" card at the bottom of the screen. More on this in the "Adding an extension" step later in the guide. The connection password (the SIP password) is created automatically when the extension is created and is shown once.
2

The Extensions screen

In the control panel, in the side menu, click Extensions (in the "Extensions and Routing" group). If you do not see the item, you do not have permission to view extensions.

Side menu The control panel side menu with the Extensions item highlighted

At the top are four numbers that give the picture in one sentence: how many extensions there are, how many of them are on a call right now, how many have a device connected, and how many have forwarding or "Do Not Disturb", meaning how many extensions will not ring right now.

The Extensions screen The Extensions screen with six sample extensions and four summary figures at the top
The extensions and names in the screenshot are examples only.

Each card answers three questions: which line it is, what state it is in right now, and where a call goes if no one answers.

An extension card A card for extension 203, Avraham from the billing department
  • The light and the word next to it: the line's state right now. Connected = a device is registered and ready. On a call = a conversation is in progress. Disconnected = no device is registered.
  • Normal mode / Do Not Disturb / Immediate Forwarding: what will happen to a call that arrives now. For forwarding, the number it is sent to is also shown.
  • Rings X seconds: how long the device rings before the call moves on.
  • Recorded · group name: which recording group the extension belongs to. "No recording" = its calls are not recorded.
  • No answer: the destination a call goes to when it is not answered. This is the row on the "thread" at the bottom of the card.

An extension that is on a call right now is marked in green: the light, the frame and the word "On a call". In place of the "No answer" row, it shows who it is talking to: the other party's number, and the name too, if the system knows it. This way you can see at a glance who is busy and with whom. The screen updates by itself, with no need to refresh.

An extension on a call A card for extension 205, marked in green and showing a call with 0501234503

Clicking Manage Extension opens the editor. For someone with view permission only, the button is called Extension Details, and the editor opens without a Save button.

3

The basic settings

At the top of the editor is one line that explains, in order, what will happen to a call that reaches the extension right now. It is worth looking at before you change anything, and after you change it.

What happens to a call that arrives now Status row: ringing, no answer, busy, unavailable

Below it are the five settings you change day to day, and the "No answer" destination selector:

Basic settings The basic settings of an extension: name, ring time, Do Not Disturb, immediate forwarding, call recording, and the No Answer destination
SettingWhat it does
Extension nameThe name that appears in the extensions list, on the Live Calls screen and in reports. The caller does not hear it. It is best to use a name that says both who and what, for example "Yossi, Technical Support".
Ring timeThe number of seconds the device rings. When the time runs out and no one has answered, the call moves to the "No answer" destination. The minimum is one second. 20-30 seconds is about 5-7 rings.
Do Not DisturbWhen this setting is on, the extension does not ring at all. The call goes immediately to the "No answer" destination.
Immediate forwardingA phone number that every call is sent to immediately. The extension does not ring, and the fallback destinations do not come into play either. Empty = no forwarding.
Call recordingWhich recording group the extension belongs to. The rules (what is recorded, what percentage, and how long it is kept) are set in the group itself, on the Call Recording screen.
Some PBXs do not allow an extension without a recording group. If this is the case in your account, every attempt to save an extension that does not belong to a group will be rejected, even a save that does not touch recording at all. A message about this appears on the screen, and the solution is to choose a recording group and save.

All the other settings are under Advanced Management. Clicking it opens them, divided into groups by topic.

Opening the advanced section The advanced management row in the extension editor
4

What happens when no one answers: the three fallback destinations

This is the important part of the guide. An extension has three separate destinations, and each one applies in a different situation. The common confusion is to think there is only one, and then calls "disappear" in a situation that has no destination set.

DestinationWhen it applies
No answerThe device rang, the ring time passed, and no one answered. It also applies when "Do Not Disturb" is on, and then without ringing at all.
BusyThe device itself returned "busy", or the extension is already handling the maximum number of simultaneous calls that was set for it.
UnavailableNo device is registered on the line: the phone is off, the app is closed, or there is no internet.

The "No answer" destination is on the basic screen, because it is the one you actually change. The other two are under "Advanced Management", in the Busy and Unavailable group.

Busy and Unavailable The destination selectors for the Busy and Unavailable states

Each of the three destinations is chosen the same way: first the destination type, then the destination itself. These are the options that are used in practice:

  • Voicemail box: the caller leaves a message. This is the most common destination for a personal extension.
  • Hunt group: the call rings several people, in stages. Good when it is important that someone answers.
  • Queue: the caller waits in a queue until an agent is free.
  • IVR menu (router): the caller goes back to a menu and chooses where to go.
  • External number: the call goes out to a regular number, for example a mobile. You type the number in the field.
  • Extension: another extension in the account.
  • Hang up: the call ends. There is no need to choose a destination. Good when there really is no one to transfer to.
Choosing "Voicemail box" as a destination is what actually activates the voicemail box. Choosing a voicemail box in the "Voicemail box" setting (in the "Incoming Calls" group) only says which box belongs to the extension. For a caller to reach it, you need to choose "Voicemail box" in one of the three fallback destinations.
A destination that points to something that was deleted will not be saved. If the destination refers to a queue or group that no longer exists, the PBX will reject the save and say so. This is a safeguard: it is better to know the destination is broken than to find out when a call disappears.
5

"Do Not Disturb" and immediate forwarding: what is the difference

Both settings stop the ringing, but the result is completely different, so it is worth knowing what you are choosing:

  • Do Not Disturb: the call does not ring at your extension and goes immediately to the "No answer" destination you set. If the destination is a voicemail box, the caller will leave a message. If the destination is a hunt group, someone else will answer. The call stays inside the PBX.
  • Immediate forwarding: the call is sent immediately to the number you entered, and does not pass through any fallback destination. "Do Not Disturb" is not taken into account either: forwarding overrides it.

In short: "Do Not Disturb" means "not to me right now, carry on according to what I set up." Immediate forwarding means "every call goes to this number."

How do you cancel? For "Do Not Disturb", turn the switch off. For immediate forwarding, delete the number from the field and leave it empty. In both cases you need to click Save Changes.

On the card on the main screen, both settings are marked in orange, so you can see in one overview who will not ring. The number at the top, "Forwarded or Do Not Disturb", counts them too.

6

Outgoing calls and caller ID

This group sets what the person you call sees, and where the extension is allowed to dial.

Outgoing calls Outgoing call settings: caller ID shown externally, internal caller ID, display name, emergency number, and dialing permission level
SettingWhat it does
What is shown on an outgoing callThe number that the person you call outside the PBX will see. You can choose the extension's own number, the account's default, or any of the numbers you have. For example, you can show the main line on every outgoing call.
What is shown on an internal callWhat another extension in the account sees when you dial it from here. This is a separate setting for each extension, with the same options: the extension's own number, the account default, or one of your numbers. "The extension's own number" makes it possible to call it back with an internal call.
Display nameA name that is shown together with the number, on devices that support it. Empty = no name.
The number sent to emergency servicesThis number is used to identify your location when you call the police, Magen David Adom (MDA) or the fire department. It is important to use a number whose registered address is correct.
Dialing permission levelWhich destinations the extension is allowed to dial, for example a level that blocks international calls. The levels themselves are defined in the PBX. Here you choose which level applies to the line.
A number that is not yours will not be displayed. You can only choose numbers that exist in the account. This is a requirement of the network, not a limit of the PBX.
Working from your private mobile, and want the customer to see the business number? The settings here apply only to calls that go out from the extension. A call that the mobile dials directly goes out with the mobile's number. To call from a mobile in the business's name, use Remote Access (in the side menu, in the "Advanced" group; if the screen doesn't appear for you, contact us): you call a business number that is routed to remote access, the system identifies you by your phone number or by an account number and PIN, and you dial from there through the PBX — the other side sees the business number chosen in the access account ("Outgoing caller ID"). See also Working from home with the PBX and What is caller ID in the Knowledge Center.
7

Incoming calls

What happens to a call that reaches the extension, and what can reach it at all.

Incoming calls Incoming call settings: screening before connecting, blocking a private number, maximum simultaneous calls, direct dialing, and voicemail box

Screening before connecting

What happens between the moment you pick up and the moment the call connects:

OptionWhat happens
NoneThe call connects immediately. This is the default.
Announce the caller's numberBefore the call connects, you hear which number it came from. Useful when you are talking without looking at the screen.
Ask the caller for their nameThe caller is asked to record their name, and you hear it before the call connects.
Play me a screening messageBefore the call connects you hear a recorded message (for example which line it came from), so you know how to answer. The caller waits on the line meanwhile.

Other settings in the group

SettingWhat it does
Block calls from a private numberA call that arrives with no caller ID will not ring at the extension.
Maximum simultaneous callsHow many calls the extension can hold at the same time. An additional call over this number gets "busy" and goes to the "Busy" destination. Checking "No limit" cancels the cap.
Direct dialing to the extensionWhen this setting is off, the extension can only be reached through internal routing (an IVR menu, queue or hunt group), and not by dialing it directly.
VoicemailWhich voicemail box belongs to the extension. For a caller to actually reach it, you need to choose "Voicemail box" in one of the fallback destinations (step 4).
8

Audio and messages

What you hear at the extension, and what a person waiting for it hears.

Audio and messages Audio settings: message language, hold music, and music instead of ringing
SettingWhat it does
Message languageThe language and voice the system uses when speaking to the extension, for example the voicemail box messages. You can choose Hebrew in a male voice, Hebrew, or English.
Hold musicWhat a caller hears when this extension has put them on hold. The list comes from the account's music files.
Music instead of ringingThe caller hears music instead of the ringing tone for as long as the extension is ringing. Useful when the ring time is long.
9

Responsibility and alerts

Who is responsible for the extension and what is reported about it.

Responsibility and alerts Responsibility settings: email for an unanswered call, extension manager, personal code, and the Do Not Dial flag
SettingWhat it does
Email about a missed callThe PBX sends a message to the extension's owner for every call that arrived and was not answered. Useful for an extension that is supposed to return calls.
Extension ownerWhich of the account's users is responsible for the extension. Alerts are sent to this person, so it is best to set them before you turn on the email.
Personal codeA code for identification in services that require one, for example entering the voicemail box from another phone. Empty = no code.
"Do Not Call" markingMarks the extension on the PBX's "Do Not Call" list, which campaigns skip.
10

The device and connection

This group relates to the line itself and the device registered on it. Usually there is no need to touch it, unless you are installing a new device or solving a connection problem.

The device and connection Device settings: connection wait, connection check, WebRTC, IP restriction, registration server, dial plan, and hardware address
SettingWhat it does
The device should be connectedWhen this setting is on, the PBX expects a registered device on the line, and when there is none, the call goes to the "Unavailable" destination. Turning it off suits a line that has no device at all.
Periodic connection checkThe PBX sends a silent check to the device, so that the "Connected" indicator is accurate even behind a home router.
Connection from the browserLets you connect a phone that runs inside a browser to the extension, with no device or app.
IP address restrictionOnly a device connecting from the addresses you entered will be allowed to register on the line. Empty = no restriction. Useful in an office with a fixed address.
Registration serverThe address of the server the device registers to, if the PBX has set a server different from the default.
Dial planHow numbers dialed from the extension are interpreted. Empty = same as the rest of the account.
Hardware addressThe identifier of the physical device, so that the PBX can configure it automatically.
The SIP password is not shown here. It is created automatically when the extension is created and shown only once. This is what you type into the adapter or the app. If it was not saved, you can generate a new one. More on this later in the section.

Who is connected to the line now

Further down in the editor there is a panel that shows the devices registered on the line right now: the device type, the address it is connected from, and when the registration was last updated. If the panel is empty, no device is connected, and every call will go to the "Unavailable" destination.

Devices registered on the line Panel of the devices registered on the line, with a Yealink device connected

New SIP password

If the SIP password was not saved, in the "Devices registered on the line" area there is a New SIP Password button. Click twice to confirm, and you get a new password that is shown once. Save it right away. A device that is already registered on the line keeps working until its next registration. At the next registration it will be required to use the new password, so you need to update it there.

11

Emergency call address

When you dial the police, MDA or the fire department from an extension, the PBX passes location details along with the call. These fields determine what will be provided.

Emergency call address Emergency address fields: location code, street and house number, and city
SettingWhat it does
Emergency location codeThe code that the PBX passes to emergency services to identify where the call is coming from.
Street and house numberThe address that will be given to emergency services on a call from this extension.
CityThe city that will be given to emergency services.
If an extension moved to another place, update the address. For an extension connected through the internet, there is no way to know where the call is coming from. What is written here is what will be sent. This also applies to an extension you work with from home. Background — How emergency calls work from a cloud PBX.
11c

Adding an extension

At the bottom of the Extensions screen, the New Extension card opens a short form:

  1. The extension number — set automatically: the number after the highest extension in the account. Only in an account that has no extensions yet do you type it yourself — a line number from the account's range; a number outside the range is rejected with an explanation.
  2. Description (display name): the name that will be shown on all screens, for example "Office, Second Floor".
  3. Call recording — which recording group to assign the extension to. In an account where every extension must be recorded, if you chose "Not recorded", the screen picks the first group itself and asks you to click "Create extension" again.
  4. Click Create Extension.
The SIP password is shown only once. After creation, the password that was generated appears. This is what you type into the device or the software so that the extension connects. Save it right away. It cannot be read again, only replaced with a new one in the extension editor, using the "New SIP Password" button in the devices registered on the line area.

Next to the password are Copy password and Open extension — which opens the new extension so you can complete the rest of the settings: ring time, fallback destinations and voicemail. The card stays on the screen until you click Got it — I saved the password.

12

Who can reach the extension, and what is fixed by the PBX

At the bottom of the editor there is a panel that answers a question that is hard to answer any other way: where do calls to this extension come from at all. The system scans all of the routing (numbers, IVR menus, queues, hunt groups and codes) and shows every route that leads here. The first scan takes a few seconds, and after that the answer is instant.

Who can reach this extension Panel showing who reaches the extension: the number, IVR menu, hunt group, and queue that point to it

Every row also says through what the call arrives: "key 2" in an IVR menu, a number's "default destination", "destination in a group", and so on. Clicking Call Route opens the full route from that point.

The same panel also opens without going into the editor. On every extension card, and at the bottom of its management screen, there is a Call Route button. It opens the route diagram with the extension as the starting point. Since a call does not continue onward from an extension, what is shown there is who forwards to it. At the top of each box in the diagram there is a Go to Settings button, which opens that entity's settings in a separate window over the diagram.

Before you turn off "Direct dialing" or change a destination, look here. This is how you know whether something will break. If an IVR menu forwards to an extension and you turned off direct dialing for it, callers coming through the IVR menu will still reach it, but anyone dialing it directly will not.

Fixed by the PBX

At the end of "Advanced Management" there is a list of fields that the PBX sets and that cannot be changed from here: the line name, the internal identifier, the region, the way the call is delivered, the caller ID display and more. They are shown for information, so you can see the real state even when there is nothing to do about it.

Fixed by the PBX The list of fields the PBX sets for an extension

Saving and permissions

  • Only the settings you actually changed are sent to the PBX. A field you did not touch is not written again.
  • If you close the window with an unsaved change, you will be asked before the change is lost.
  • If the PBX rejects a change, a message appears that explains what to fix, for example a ring time that is too small or a destination that does not exist.
  • Editing requires edit permission for Extensions. Without it, the editor opens as read-only, with no Save button.
  • Delete extension appears only for those with delete permission. Deleting disconnects the device registered on the line and deletes all its settings, and there is no way back — so you have to type the extension number and confirm with "Delete Permanently".

The editor also has sections for automatic transcription (for a recorded extension) and for call filtering — the details are in their guides.

Stuck? Does something on the screen not behave like in the guide? Write to us through the Contact Us page. We'll be glad to help, and also to hear what's missing from the guide.