Customize M365 Profile Card

Customize M365 Profile Card

Hi All,

Recently i have stumbled across the following Article on how to extend the M365 Profile card with custom Entra ID Attributeds

Add or remove custom attributes on a profile card using the profile card API

You can only use the following Attributes

  • UserPrincipalName
  • Fax
  • StreetAddress
  • PostalCode
  • StateOrProvince
  • Alias


  • customAttribute1
  • customAttribute2
  • customAttribute3
  • customAttribute4
  • customAttribute5
  • customAttribute6
  • customAttribute7
  • customAttribute8
  • customAttribute9
  • customAttribute10
  • customAttribute11
  • customAttribute12
  • customAttribute13
  • customAttribute14
  • customAttribute15

In Graph Explorer we can check the current Profile Card Properties


Make sure you have these Permissions

  • PeopleSettings.Read.All
  • PeopleSettings.ReadWrite.All

To add the Custom Attribute 15 with localizations use this Request Body

#Content-Type application/json
    "directoryPropertyName": "customAttribute15",
    "annotations": [
            "displayName": "Cost center",
            "localizations": [
                    "languageTag": "de-CH",
                    "displayName": "Kostenstelle"
                    "languageTag": "fr-CH",
                    "displayName": "Centre de coûts"
                    "languageTag": "it-CH",
                    "displayName": "Centro di costo"

Make sure that you use the correct Request headers

Content-Type application/json

You can also use the Microsoft.Graph PowerShell Module

Connect-MgGraph -Scopes "PeopleSettings.ReadWrite.All","PeopleSettings.Read.All"
#Get ProfileCard Properties

Add the Alias with Microsoft.Graph PowerShell Module

#Add Alias to Profile Card
$params = @{
  "directoryPropertyName" = "Alias"

New-MgAdminPeopleProfileCardProperty -BodyParameter $params

#Get ProfileCard Properties

To remove the Alias with Microsoft.Graph PowerShell use the following Command

Remove-MgAdminPeopleProfileCardProperty -ProfileCardPropertyId Alias

Profile Card in Outlook on the Web (before)

Profile Card in Microsoft Teams (before)

Changes can take up to 24 Hours. In my Test the Alias was pretty fast visible, but the customAttribute took at least 12 Hours.

Profile Card in Outlook on the Web (after)

Profile Card in Microsoft Teams (after)

Andres Bohren

M365 Logo