Skip to content

Commit 105311f

Browse files
octoshinCopilotmchammer01
authored
adding display name docs (#59432)
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com>
1 parent d46abec commit 105311f

5 files changed

Lines changed: 60 additions & 8 deletions

File tree

content/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/configuring-custom-footers.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,7 @@ You can configure the web UI for your enterprise to display a custom footer with
2222

2323
{% data reusables.enterprise-accounts.access-enterprise %}
2424
{% data reusables.enterprise-accounts.settings-tab %}
25-
1. Under **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Settings**, click **Profile**.
26-
1. At the top of the page, under the navigation bar, click **Custom footer**.
27-
28-
![Screenshot of the "Profile" page for an enterprise account. A tab, labeled "Custom footer", is outlined in dark orange.](/assets/images/enterprise/custom-footer/custom-footer-section.png)
25+
1. Under **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Settings**, click **General**.
26+
1. Navigate to **Custom footer**.
2927
1. Under each "Footer Link" heading, type a title and URL.
30-
1. To save the content and display the custom footer, click **Update custom footer**.
28+
1. To save the content and display the custom footer, click **Update footer**.
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
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.

content/admin/managing-your-enterprise-account/deleting-an-enterprise-account.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ If you upgraded to an enterprise account from a single organization and then del
4242
{% data reusables.enterprise-accounts.access-enterprise %}
4343
{% data reusables.enterprise-accounts.settings-tab %}
4444
1. If you are not trialing {% data variables.product.prodname_ghe_cloud %}, delete your enterprise account:
45-
1. Under **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Settings**, click **Profile**.
45+
1. Under **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Settings**, click **General**.
4646
1. In the "Danger Zone" section, click **Delete this enterprise**.
4747
1. In the text box, type the enterprise slug to confirm the deletion, then click **Delete this enterprise**.
4848
1. If you are trialing {% data variables.product.prodname_ghe_cloud %}, cancel your trial, or delete the expired trial:

content/admin/managing-your-enterprise-account/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,6 @@ children:
99
- /creating-a-readme-for-an-enterprise
1010
- /deleting-an-enterprise-account
1111
- /changing-the-url-for-your-enterprise
12+
- /configuring-user-display-names-for-your-enterprise
1213
shortTitle: Manage enterprise account
1314
---
14-

content/admin/overview/setting-up-a-trial-of-github-enterprise-cloud.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ You can cancel a trial at any time. Once the trial has expired, you can delete t
114114

115115
{% data reusables.enterprise-accounts.access-enterprise %}
116116
{% data reusables.enterprise-accounts.settings-tab %}
117-
1. Under **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Settings**, click **Profile**.
117+
1. Under **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Settings**, click **General**.
118118
1. At the bottom of the page, in the "Danger zone" section, click **Cancel trial** or **Delete trial**.
119119

120120
## Further reading

0 commit comments

Comments
 (0)