How to Configure Yealink T1 and T2 Series
Important
- Yealink T27P and T29G are marked as 3rd party.
- Yealink T19P, T20P, T21P, T22P, T26P, T28P are EOL and can only be manually configured.
- If it's a used phone, previously connected to another PBX system, you have to reset it first. See how to do this here.
- T27P/G no longer works with the EXP20 expansion module.
- T29G no longer works with the EXP20 expansion module.
- If it’s an old phone, you might have to upgrade its firmware to the latest 3CX supported version. See how to do this here.
Step 1: Identify your Exact Yealink T1 and T2 Phone Model and MAC Address
Be sure you follow the steps for the correct phone model. You can find the model and MAC address on the label at the back of the handset, or by pressing the “Menu or OK > Status” on the phone. Take a note of the MAC address, you will need this for the configuration.
Step 2: Add The Phone to the Extension
From the admin console in your web client:
- Go to “Users” and select the user you want to add a phone for.
- Click on the “IP Phone” tab. Click “Configure a phone” to add a phone.
- Now select your phone model from the dropdown menu.
- Enter the phone’s MAC address without dashes or colons, and click “Add phone”.
Step 3: Router Phone, SBC or LAN?
- If 3CX is on the cloud, you must use a router phone or SBC:
- If it is not a router phone you need to specify one or an SBC.
- If the device is a router phone, you can connect it directly as a router itself.
- If 3CX is on premise or self hosted, you have an additional option, you can select “Local LAN/VPN”.
- Click “Add Phone” to save the phone configuration for this extension.
Step 4: Connect the Phone
3CX will now create provisioning information for the phone and make these available on the provisioning URL. The phone must connect to this URL to retrieve its configuration information and authentication details. You have the following options:
- RPS - Connect the phone to the network within 14 days. If it is already connected, restart it. The phone will be configured automatically and restarted.
- PNP - If 3CX is on premise or connected via SBC, you can connect the phone to the LAN and look for it in the PNP dialog (Admin Console > Phones > PNP Phones). Right click and assign it to the extension you configured above.
Alternatively you can login to the phone's webUI and enter the URL manually. You can also use DHCP option 66.
See also
- Configuring your IP Phones with 3CX
- Configuration guides for popular DECT phones
- Snom M300, M400, M900 (DECT phone)
- Gigaset N670 IP PRO, N870 IP PRO (DECT phone)
- Yealink W70, W80, W90 (DECT phone)
- See our list of supported IP phones and DECT phones.
- IP Phone Configuration Options, configurable per device of the extension
- Customising the IP Phone background logo
Last Updated
This document was last updated on 18 June 2025