Manage caller ID policies for users


This article describes how to manage caller ID settings for your users. You can:

  • Display an alternate phone number for Teams users in your organization.
  • Block the outbound phone number.
  • Block an incoming number from being displayed.
  • Set the Calling Party Name (CNAM). For example, when a user makes a call, you can change the caller ID to display your organization's main phone number and company name instead of the user's phone number.

With settings turned off, the Teams user's phone number is visible when that user makes a call to the Public Switched Telephone Network (PSTN). Likewise, when a PSTN caller makes a call to a Teams user, the PSTN caller's phone number is visible. By default, the following caller ID settings are turned off.

  • Block incoming caller ID: Block a user from receiving caller ID on any incoming PSTN calls.

  • Override the caller ID policy: Allow users to override the settings in the policy that decide whether or not they display their number to the callee. This means that users can choose whether to display their caller ID. For more information, see End user control of outbound caller ID.

  • Set Calling Party Name (CNAM): Send a CNAM on outbound PSTN calls.

  • Replace outgoing caller ID: Replace a user's caller ID, which by default is their telephone number, with another phone number. For example, you can change the user's caller ID from their phone number to a main phone number for your business or to a main phone number for the legal department. You can set the calling ID number to any Calling Plan, Operator Connect, or Direct Routing phone number assigned to a resource account used by an Auto Attendant or a Call Queue.

  • Block outbound caller ID: Block the outgoing caller ID from being sent on a user's outgoing PSTN calls. Doing this will block their phone number from being displayed on the phone of a person being called. This means that the call is seen as coming from Anonymous.


Emergency calls will always send the user's telephone number (caller ID).

To learn more about these settings and how you can use them, see How can caller ID be used in your organization.

Set up and manage caller ID policies

You can configure caller ID policies by using the Teams admin center or by using PowerShell.


Using the service number calling ID substitute will be deprecated. Use Resource account substitution instead.

Use the Teams admin center

You can manage caller ID policies by going to Voice > Caller ID policies in the Microsoft Teams admin center. You can use the global (Org-wide default) policy or create and assign custom policies. Users in your organization will automatically get the global policy unless you create and assign a custom policy.

Create a custom caller ID policy

  1. In the left navigation of the Microsoft Teams admin center, go to Voice > Caller ID policies.

  2. Select Add.

  3. Enter a name and description for the policy.

  4. Under Replace the caller ID with, set which caller ID is displayed for users by selecting one of the following:

    • User's number: Display the user's number.
    • Service number: Display the service number. (Note: this option will be deprecated.)
    • Anonymous: Display the caller ID as Anonymous.
    • Resource account: Set a resource account associated with an Auto Attendant or Call Queue.

    The option you choose determines next steps. If you choose Service number or Resource account, you are prompted to specify a service number or a resource account, respectively.

  5. Select Save.

Assign a custom caller ID policy to users

You can assign a policy directly to users, either individually or at scale through a batch assignment (if supported for the policy type), or to a group that the users are members of (if supported for the policy type).

To learn about the different ways that you can assign policies to users, see Assign policies to your users in Teams.

Edit a caller ID policy

You can edit the global policy or any custom policies that you create.

  1. In the left navigation of the Microsoft Teams admin center, go to Voice > Caller ID policies.
  2. Select the policy by clicking to the left of the policy name, and then select Edit.
  3. Change the settings that you want, and then select Save.

Use PowerShell

You can manage caller ID policies by using the following PowerShell cmdlets in Teams PowerShell module 2.3.1 or later:

New custom caller ID policy

This example creates a new caller ID policy that sets the caller ID to the phone number of the specified resource account and sets the Calling party name to Contoso:

$ObjId = (Get-CsOnlineApplicationInstance -Identity
New-CsCallingLineIdentity -Identity DKCQ -CallingIDSubstitute Resource -EnableUserOverride $false -ResourceAccount $ObjId -CompanyName "Contoso"

This example creates a new caller ID policy that sets the caller ID to Anonymous:

New-CsCallingLineIdentity -Identity Anonymous -Description "anonymous policy" -CallingIDSubstitute Anonymous -EnableUserOverride $false

Change a caller ID policy

This example modifies the UKAA caller ID policy to set a new description.

Set-CsCallingLineIdentity -Identity "UKAA" -Description "UK Main office"

Remove a caller ID policy

This example removes the UKAA caller ID policy.

Remove-CsCallingLineIdentity -Identity "UKAA"

Grant a caller ID policy

This example grants the Anonymous caller ID policy to Amos Marble.

Grant-CsCallingLineIdentity -Identity "" -PolicyName "Anonymous"