|
| 1 | +--- |
| 2 | +title: 'Configuring user display names for your enterprise' |
| 3 | +intro: 'You can choose whether the profile name (first and last name) of your enterprise members appear alongside their username across {% data variables.product.github %}.' |
| 4 | +versions: |
| 5 | + ghec: '*' |
| 6 | + ghes: '*' |
| 7 | +contentType: how-tos |
| 8 | +topics: |
| 9 | + - Accounts |
| 10 | + - Enterprise |
| 11 | +permissions: Enterprise and organization admins can configure whether profile names (first and last name) appear alongside usernames across {% data variables.product.github %}. |
| 12 | +shortTitle: Configure user display names |
| 13 | +--- |
| 14 | + |
| 15 | +## About user display names for enterprises |
| 16 | + |
| 17 | +A user display name controls how enterprise members are shown across {% data variables.product.prodname_enterprise %}. When the feature is enabled, a member’s profile name (first and last name) appears alongside their username in places like repositories, issues, pull requests, and {% data variables.product.prodname_discussions %}. The setting applies to public, private, and internal repositories within your enterprise's organizations. |
| 18 | + |
| 19 | +When set at the enterprise level, this policy is applied across all organizations within your enterprise. |
| 20 | + |
| 21 | +Once configured, your chosen display format will be visible throughout these key areas: |
| 22 | + |
| 23 | +* Pull requests: reviewers, assignees, pull request authors, activities, comments, @-mentions, and commits |
| 24 | +* Issues: assignee, comments, activities, @-mentions, and owner |
| 25 | +* Discussions: discussion owners, comments, and @-mentions |
| 26 | +* Projects: assignee |
| 27 | + |
| 28 | +By default: |
| 29 | + |
| 30 | +* {% data variables.product.prodname_ghe_cloud %} with {% data variables.product.prodname_emus %} and {% data variables.product.prodname_ghe_server %} show profile names alongside usernames. |
| 31 | +* All other enterprise accounts show usernames only. |
| 32 | + |
| 33 | +## Changing the user display name setting for an enterprise |
| 34 | + |
| 35 | +{% data reusables.enterprise-accounts.access-enterprise %} |
| 36 | +{% data reusables.enterprise-accounts.settings-tab %} |
| 37 | +1. On the "Manage your enterprise profile" page, go to "Member appearance". |
| 38 | +1. Under "Profile name visibility", select one of the following options in the adjacent dropdown list. |
| 39 | + * **Enable everywhere** to show profile names alongside usernames across all organizations in your enterprise, including in repositories, issues, pull requests, and discussions. |
| 40 | + * **Disable everywhere** to show **usernames only** across all organizations in your enterprise. |
| 41 | + * **Let organizations decide** to allow each organization in your enterprise to configure this setting. |
| 42 | + |
| 43 | +## Changing the user display name setting for an organization |
| 44 | + |
| 45 | +> [!NOTE] |
| 46 | +> The organization-level setting will only be configurable if the enterprise-level policy is set to **Let organizations decide**. |
| 47 | +
|
| 48 | +To manage configure user display name at the organization level: |
| 49 | +{% data reusables.profile.access_org %} |
| 50 | +{% data reusables.profile.org_settings %} |
| 51 | +1. On the "Manage your enterprise profile" page, go to "Member appearance". |
| 52 | +1. Under "Profile name visibility", select one of the following options in the toggle. |
| 53 | + * **On** to show profile names alongside usernames in your organization, including in repositories, issues, pull requests, and discussions. |
| 54 | + * **Off** to show **usernames only** across your organization. |
0 commit comments