Skip to content

Commit 4d85658

Browse files
authored
Merge pull request #42419 from github/repo-sync
Repo sync
2 parents 78789af + ca67b2d commit 4d85658

File tree

8 files changed

+374
-29
lines changed

8 files changed

+374
-29
lines changed

CHANGELOG.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,21 @@
11
# Docs changelog
22

3+
**16 January 2026**
4+
5+
We published [About user offboarding on GitHub Enterprise Cloud](https://docs.github.com/en/enterprise-cloud@latest/admin/concepts/identity-and-access-management/user-offboarding) to give enterprise customers clear guidance about offboarding processes. The article covers recommended offboarding methods, the effects of offboarding, and what happens when a user is removed from all organizations in an enterprise.
6+
7+
We also updated [Removing a member from your enterprise](https://docs.github.com/en/enterprise-cloud@latest/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/removing-a-member-from-your-enterprise) and [Removing a member from your organization](https://docs.github.com/en/enterprise-cloud@latest/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization) to include instructions for enterprises that use Enterprise Managed Users or SCIM for organizations.
8+
9+
<hr>
10+
11+
**13 January 2026**
12+
13+
We've added a new reference article to clarify which of the various types of custom instructions for Copilot are supported by Copilot Chat, Copilot coding agent, and Copilot code review in GitHub.com, Visual Studio Code, Visual Studio, JetBrains IDEs, Eclipse, Xcode, and Copilot CLI.
14+
15+
[Support for different types of custom instructions](https://docs.github.com/copilot/reference/custom-instructions-support)
16+
17+
<hr>
18+
319
**8 January 2026**
420

521
We've added information about permissions to the article [Using GitHub Copilot CLI](https://docs.github.com/copilot/how-tos/use-copilot-agents/use-copilot-cli#permissions).

content/admin/concepts/identity-and-access-management/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ topics:
1010
children:
1111
- /identity-and-access-management-fundamentals
1212
- /enterprise-managed-users
13+
- /user-offboarding
1314
contentType: concepts
1415
---
1516

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
title: About user offboarding on {% data variables.product.prodname_ghe_cloud %}
3+
shortTitle: User offboarding
4+
intro: 'Manage access with confidence by understanding the recommended approach for offboarding users.'
5+
versions:
6+
ghec: '*'
7+
contentType: concepts
8+
topics:
9+
- Accounts
10+
- Authentication
11+
- Enterprise
12+
- Identity
13+
- SSO
14+
---
15+
16+
## How should I offboard users?
17+
18+
The method for offboarding a user depends on your enterprise type:
19+
20+
* **Personal accounts**: Remove the user from the enterprise account using the {% data variables.product.github %} UI or API.
21+
* Outside collaborators are an exception to this process. They cannot be removed in the enterprise settings, and must be removed from each repository instead.
22+
* **{% data variables.product.prodname_emus %}**: Suspend the user's account by removing the user from the {% data variables.product.github %} application in your identity provider.
23+
* The user will show as suspended on your enterprise's "People" page.
24+
* It is **not** possible to remove a {% data variables.enterprise.prodname_managed_user %} from the enterprise completely.
25+
26+
For instructions, see [AUTOTITLE](/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/removing-a-member-from-your-enterprise).
27+
28+
## What happens when a user is offboarded?
29+
30+
When you offboard a user by following the instructions linked above:
31+
32+
* The offboarded user loses access to private and internal resources in your enterprise and organizations.
33+
* The user's {% data variables.product.pat_generic_plural %}, SSH keys, and app authorizations can no longer be used to access your enterprise's and organizations' resources. Access to your resources is restored if the user is added back to the enterprise and relevant organizations.
34+
* The user stops consuming licenses granted from your enterprise, including {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_copilot %} licenses. This change may not be reflected on your bill until the next billing cycle.
35+
* If you use {% data variables.product.prodname_emus %}, the user will no longer be able to sign in to their {% data variables.enterprise.prodname_managed_user %}.
36+
* If you use an enterprise with personal accounts, the user will still be able to sign in to their account and access other resources on {% data variables.product.github %}, even if you have enabled SAML SSO for your enterprise or organizations. This is because SSO only applies to your enterprise- or organization-owned resources.
37+
* The user's commits, issues, pull requests, comments, and so on are retained in organization-owned repositories. However, the user's username is obfuscated if you use {% data variables.product.prodname_emus %}.
38+
39+
For {% data variables.product.prodname_emus %}, you will find a more exhaustive list of effects of offboarding in [AUTOTITLE](/admin/managing-iam/provisioning-user-accounts-with-scim/deprovisioning-and-reinstating-users).
40+
41+
## What about removing a user from all organizations?
42+
43+
Historically, some enterprises' offboarding processes have relied on removing a user from all organizations in the enterprise. However, in many cases, this approach is **not** sufficient for fully offboarding a user.
44+
45+
### When is a user removed from the enterprise?
46+
47+
If a user loses access to all organizations in an enterprise, the user is also removed from the enterprise account if **all** of the following things are true:
48+
49+
* You use an enterprise with **personal accounts**.
50+
* Your enterprise has **disabled** the policy described in [AUTOTITLE](/admin/enforcing-policies/enforcing-policies-for-your-enterprise/control-offboarding).
51+
* The user does **not** have the enterprise owner or enterprise billing manager role.
52+
53+
### What happens if a user remains in the enterprise?
54+
55+
In **any** other situation, a user who loses access to all organizations remains in the enterprise.
56+
57+
* If the user has the enterprise owner or enterprise billing manager role, they remain in the enterprise with this role.
58+
* If the user doesn't have one of those roles, the user becomes an unaffiliated user.
59+
60+
Users without organization membership cannot access internal repositories in the enterprise. They also do not consume a {% data variables.product.prodname_enterprise %} license, unless they meet another criterion listed in [AUTOTITLE](/billing/reference/github-license-users#organizations-on-github-enterprise-cloud). However, they keep other privileges including enterprise roles and {% data variables.product.prodname_copilot %} licenses granted directly from the enterprise.
61+
62+
For more information, see [AUTOTITLE](/admin/managing-accounts-and-repositories/managing-roles-in-your-enterprise/abilities-of-roles).
Lines changed: 28 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Removing a member from your enterprise
3-
intro: You can remove an enterprise member from an enterprise.
4-
permissions: Enterprise owners can remove an enterprise member from an enterprise.
3+
intro: Offboard users from an enterprise by following the recommended approach for your enterprise type.
4+
permissions: Enterprise owners or IdP administrators
55
versions:
66
feature: remove-enterprise-members
77
type: how_to
@@ -12,23 +12,38 @@ redirect_from:
1212
- /admin/user-management/managing-users-in-your-enterprise/removing-a-member-from-your-enterprise
1313
---
1414

15-
## About removal of enterprise members
15+
The recommended offboarding approach for your enterprise depends on whether you use personal accounts or {% data variables.product.prodname_emus %}. To learn more about the effects of offboarding users, see [AUTOTITLE](/admin/concepts/identity-and-access-management/user-offboarding).
1616

17-
If your enterprise does not use {% data variables.product.prodname_emus %}, you can remove an enterprise member from your enterprise on {% data variables.product.prodname_dotcom_the_website %}. When you remove a member from your enterprise, the member is removed from all organizations owned by your enterprise and loses access to any {% data variables.copilot.copilot_business_short %} licenses assigned through those organizations. Removing a member from your enterprise also removes any of the member's administrative roles, such as the owner or billing manager roles. See [AUTOTITLE](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise).
17+
## Removing a member from an enterprise with personal accounts
1818

19-
If the enterprise member you're removing is the last owner of an organization owned by your enterprise, you will become an owner of that organization.
20-
21-
If your enterprise or any of the organizations owned by your enterprise uses an identity provider (IdP) to manage organization membership, the member may be added back to the organization by the IdP. Make sure to also make any necessary changes in your IdP.
19+
When you remove a member from your enterprise, the member is removed from all organizations owned by your enterprise and loses privileges granted through the enterprise, such as roles or licenses.
2220

23-
If your enterprise does use {% data variables.product.prodname_emus %}, you must remove the enterprise members through your identity provider (IdP) and the SCIM integration instead. See [AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users#about-organization-membership-management).
24-
25-
## Removing a member from your enterprise
21+
If the enterprise member you're removing is the last owner of an organization owned by your enterprise, you will become an owner of that organization.
2622

27-
> [!NOTE]
28-
> If an enterprise member uses only {% data variables.product.prodname_ghe_server %}, and not {% data variables.product.prodname_ghe_cloud %}, you cannot remove the enterprise member this way.
23+
>[!TIP] For automated offboarding, you can also remove users with the GraphQL API. See [AUTOTITLE](/graphql/reference/mutations#removeenterprisemember).
2924
30-
{% data reusables.enterprise-accounts.access-enterprise %}
25+
{% data reusables.enterprise-accounts.access-enterprise-personal-accounts %}
3126
{% data reusables.enterprise-accounts.people-tab %}
3227
1. To the right of the person you want to remove, select the {% octicon "kebab-horizontal" aria-label="Member settings" %} dropdown menu and click **Remove from enterprise**.
3328

3429
![Screenshot of a user in the list of enterprise members. A dropdown menu, labeled with a kebab icon, is highlighted with an orange outline.](/assets/images/help/business-accounts/remove-member.png)
30+
31+
1. If your enterprise uses SAML SSO, or if any of your organizations use SAML and SCIM provisioning, **remove the user's access to {% data variables.product.github %} apps on your identity provider**. A user may be assigned access directly or via an IdP group assigned to the app: make sure to remove the user from both. For organizations with SCIM provisioning enabled, this should trigger a SCIM deprovisioning call, which ensures that the user's associated SAML and SCIM identities are fully removed from the organization.
32+
33+
This is a good practice for security, and it also helps ensure that users cannot rejoin the organization using the SAML endpoint when SAML is configured at the organization level (see [AUTOTITLE](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on#adding-members-to-an-organization-using-saml-sso)).
34+
35+
If the user is still listed as an enterprise member, this may be because the user is a member of a {% data variables.product.prodname_ghe_server %} instance that is linked to your enterprise via {% data variables.product.prodname_github_connect %}. You will need to remove this user from the {% data variables.product.prodname_ghe_server %} settings.
36+
37+
## Suspending a user with {% data variables.product.prodname_emus %}
38+
39+
With {% data variables.product.prodname_emus %}, including all enterprises on {% data variables.enterprise.data_residency_site %}, you manage user access from your identity provider (IdP).
40+
41+
To offboard a user, you will suspend their account rather than removing them from the enterprise completely.
42+
43+
1. Trigger a deprovisioning call for the user. For more information about the types of deprovisioning and the actions that trigger it for different integrations, see [AUTOTITLE](/admin/managing-iam/provisioning-user-accounts-with-scim/deprovisioning-and-reinstating-users#triggers-of-soft-deprovisioning).
44+
1. Check if the user's organization membership is managed directly or managed by IdP groups. See [AUTOTITLE](/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/viewing-people-in-your-enterprise#filtering-by-member-type-in-an-enterprise-with-managed-users).
45+
1. If the user's organization membership is managed directly, remove the user manually from all organizations. See [AUTOTITLE](/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization).
46+
47+
## Removing an outside collaborator
48+
49+
In enterprises that use personal accounts, you cannot remove outside collaborators using the enterprise settings. However, an organization owner can remove an outside collaborator from all repositories in an organization. See [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-outside-collaborators/removing-an-outside-collaborator-from-an-organization-repository).

content/admin/monitoring-and-managing-your-instance/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,5 +15,6 @@ children:
1515
- /configuring-clustering
1616
- /configuring-high-availability
1717
- /caching-repositories
18+
- /multiple-data-disks
1819
shortTitle: 'Monitor and manage your instance'
1920
---

0 commit comments

Comments
 (0)