Skip to content

Commit ee8bee8

Browse files
jmarlena“jmarlena”lecoursenethanpalm
authored
Enterprise owners visibility in orgs (#23648)
* Steps added * Clarify how licensing works * Cleanup * Reframing * Rehashing * More descriptive subheader * Update permissions statements to work with custom roles * Tweak * Ship with permissions update * Escape ' * H2 ftw * Tweaks from a distanced read * Apply suggestions from code review Co-authored-by: Laura Coursen <lecoursen@github.com> * Apply the spirit of @lecoursen's ✨ * version custom roles link for GHEC only * Add feature-based versioning * Make top of chart more visible * Rework this tricky line Co-authored-by: “jmarlena” <“jmarlena@github.com”> Co-authored-by: Laura Coursen <lecoursen@github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
1 parent 26d2c54 commit ee8bee8

6 files changed

Lines changed: 48 additions & 4 deletions

File tree

16.1 KB
Loading
86.7 KB
Loading
15.7 KB
Loading

content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/viewing-peoples-roles-in-an-organization.md

Lines changed: 41 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: Viewing people's roles in an organization
33
intro: 'You can view a list of the people in your organization and filter by their role. For more information on organization roles, see "[Roles in an organization](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)."'
4+
permissions: "Organization members can see people's roles in the organization."
45
redirect_from:
56
- /articles/viewing-people-s-roles-in-an-organization
67
- /articles/viewing-peoples-roles-in-an-organization
@@ -15,14 +16,51 @@ topics:
1516
- Accounts
1617
shortTitle: View people in an organization
1718
---
19+
20+
## View organization roles
21+
22+
{% data reusables.profile.access_org %}
23+
{% data reusables.user_settings.access_org %}
24+
{% data reusables.organizations.people %}
25+
4. You will see a list of the people in your organization. To filter the list by role, click **Role** and select the role you're searching for.
26+
![click-role](/assets/images/help/organizations/view-list-of-people-in-org-by-role.png)
27+
28+
{% ifversion fpt %}
29+
30+
If your organization uses {% data variables.product.prodname_ghe_cloud %}, you can also view the enterprise owners who manage billing settings and policies for all your enterprise's organizations. For more information, see [the {% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/viewing-peoples-roles-in-an-organization#view-enterprise-owners-and-their-roles-in-an-organization).
31+
32+
{% endif %}
33+
34+
{% if enterprise-owners-visible-for-org-members %}
35+
## View enterprise owners and their roles in an organization
36+
37+
If your organization is managed by an enterprise account, then you can view the enterprise owners who manage billing settings and policies for all of your enterprise's organizations. For more information about enterprise accounts, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/get-started/learning-about-github/types-of-github-accounts)."
38+
39+
You can also view whether an enterprise owner has a specific role in the organization. Enterprise owners can also be an organization member, any other organization role, or be unaffililated with the organization.
40+
1841
{% note %}
1942

20-
**Note:** You must be an organization member to see people's roles in your organization.
43+
**Note:** If you're an organization owner, you can also invite an enterprise owner to have a role in the organization. If an enterprise owner accepts the invitation, a seat or license in the organization is used from the available licenses for your enterprise. For more information about how licensing works, see "[Roles in an enterprise](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owner)."
2144

2245
{% endnote %}
2346

47+
| **Enterprise role** | **Organization role** | **Organization access or impact** |
48+
|----|----|----|----|
49+
| Enterprise owner | Unaffililated or no official organization role | Cannot access organization content or repositories but manages enterprise settings and policies that impact your organization. |
50+
| Enterprise owner | Organization owner | Able to configure organization settings and manage access to the organization's resources through teams, etc. |
51+
| Enterprise owner | Organization member | Able to access organization resources and content, such as repositories, without access to the organization's settings. |
52+
53+
To review all roles in an organization, see "[Roles in an organization](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)." {% ifversion ghec %} An organization member can also have a custom role for a specific repository. For more information, see "[Managing custom repository roles for an organization](/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization)."{% endif %}
54+
55+
For more information about the enterprise owner role, see "[Roles in an enterprise](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owner)."
56+
2457
{% data reusables.profile.access_org %}
2558
{% data reusables.user_settings.access_org %}
2659
{% data reusables.organizations.people %}
27-
4. You will see a list of the people in your organization. To filter the list by role, click **Role** and select the role you're searching for.
28-
![click-role](/assets/images/help/organizations/view-list-of-people-in-org-by-role.png)
60+
4. In the left sidebar, under "Enterprise permissions", click **Enterprise owners**.
61+
![Screenshot of "Enterprise owners" option in sidebar menu](/assets/images/help/organizations/enterprise-owners-sidebar.png)
62+
5. View the list of the enterprise owners for your enterprise. If the enterprise owner is also a member of your organization, you can see their role in the organization.
63+
64+
![Screenshot of list of Enterprise owners and their role in the organization](/assets/images/help/organizations/enterprise-owners-list-on-org-page.png)
65+
66+
{% endif %}

content/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ Enterprise owners have complete control over the enterprise and can take every a
4242

4343
Enterprise owners cannot access organization settings or content unless they are made an organization owner or given direct access to an organization-owned repository. Similarly, owners of organizations in your enterprise do not have access to the enterprise itself unless you make them enterprise owners.
4444

45-
An enterprise owner will only consume a license if they are an owner or member of at least one organization within the enterprise. {% ifversion ghec %}Enterprise owners must have a personal account on {% data variables.product.prodname_dotcom %}.{% endif %} As a best practice, we recommend making only a few people in your company enterprise owners, to reduce the risk to your business.
45+
An enterprise owner will only consume a license if they are an owner or member of at least one organization within the enterprise. Even if an enterprise owner has a role in multiple organizations, they will consume a single license. {% ifversion ghec %}Enterprise owners must have a personal account on {% data variables.product.prodname_dotcom %}.{% endif %} As a best practice, we recommend making only a few people in your company enterprise owners, to reduce the risk to your business.
4646

4747
## Enterprise members
4848

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# Reference: Issue #5741 in docs-content
2+
# Documentation for enterprise owners UI updates
3+
versions:
4+
ghes: '>=3.4'
5+
ghae: 'issue-####'
6+
ghec: '*'

0 commit comments

Comments
 (0)