Skip to content

Latest commit

 

History

History
85 lines (68 loc) · 5.94 KB

reinstating-a-former-member-of-your-organization.md

File metadata and controls

85 lines (68 loc) · 5.94 KB
Raw
title intro redirect_from versions permissions topics shortTitle
Reinstating a former member of your organization
You can {% ifversion fpt or ghec %}invite former organization members to rejoin{% else %}add former members to{% endif%} your organization, and choose whether to restore the person's former role, access permissions, forks, and settings.
/articles/reinstating-a-former-member-of-your-organization
/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization
fpt ghes ghec
*
*
*
Organization owners can reinstate a former member of an organization.
Organizations
Teams
Reinstate a member

About member reinstatement

If a user is removed from your organization in one of the following ways, the user's access privileges and settings are saved for three months.

  • You manually removed the user from your organization. For more information, see "AUTOTITLE." {%- ifversion ghec %}
  • The user was removed via SCIM. For more information, see "AUTOTITLE." {%- endif %}
  • The user was removed from your organization because you've required members and outside collaborators to enable two-factor authentication (2FA). For more information, see "AUTOTITLE."{% ifversion fpt or ghec %}
  • The user was removed from your organization because you enforced SAML single sign-on. For more information, see "AUTOTITLE{% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %}{% endif %}
  • You converted an organization member to an outside collaborator. For more information, see "AUTOTITLE."

You can restore the user's privileges if you {% ifversion fpt or ghec %}invite{% else %}add{% endif %} them back to the organization within that time frame.

{% ifversion fpt or ghec %} If your organization has a paid per-user subscription, an unused license must be available before you can reinstate a former organization member. For more information, see "AUTOTITLE." {% endif %}

Items that are restored for reinstated members

When you reinstate a former organization member, the following items can be restored:

  • The user's role in the organization
  • Any private forks of repositories owned by the organization
  • Membership in the organization's teams
  • Previous access and permissions for the organization's repositories
  • Stars for organization repositories
  • Issue assignments in the organization
  • Repository subscriptions (notification settings for watching, not watching, or ignoring a repository's activity)

{% ifversion ghec %}

Reinstating a former member of your organization

The correct way to reinstate a former member depends on your organization's identity and access management configuration.

  • If the user was removed via SCIM because they were unassigned from the {% data variables.product.product_name %} application in your IdP, re-invite the user via SCIM by re-assigning them to the application. The user's organization membership will be reinstated after they sign into {% data variables.product.prodname_dotcom_the_website %} and accept the invitation.
  • If your organization uses SAML but not SCIM, ask the user to authenticate via SAML single sign-on, via your IP or by signing into {% data variables.product.prodname_dotcom_the_website %}, navigating to the organization, and clicking the banner to authenticate via SAML single sign-on. The user's organization membership will be reinstated after they successfully authenticate.
  • Otherwise, invite the user to rejoin your organization on {% data variables.product.prodname_dotcom %}, following the steps below.

{% endif %}

Reinstating a former member of your organization on {% data variables.product.prodname_dotcom %}

{% data reusables.two_fa.send-invite-to-reinstate-user-before-2fa-is-enabled %}

{% ifversion ghes %} If an organization member was removed from the organization because they did not use two-factor authentication and your organization still requires members to use 2FA, the former member must enable two-factor authentication before you can reinstate their membership. {% endif %}

{% data reusables.profile.access_org %} {% data reusables.user-settings.access_org %} {% data reusables.organizations.people %} {% data reusables.organizations.invite_member_from_people_tab %} {% data reusables.organizations.reinstate-user-type-username %} {% ifversion fpt or ghec %}

  1. Select whether to restore that person's previous privileges in the organization or clear their previous privileges and set new access permissions, then click Invite and reinstate or Invite and start fresh. {% else %}
  2. Select whether to restore that person's previous privileges in the organization or clear their previous privileges and set new access permissions, then click Add and reinstate or Add and start fresh. {% endif %} {% ifversion fpt or ghec %}
  3. If you cleared the previous privileges for a former organization member, choose a role for the user, and optionally add them to some teams, then click Send invitation. {% else %}
  4. If you cleared the previous privileges for a former organization member, choose a role for the user, and optionally add them to some teams, then click Add member. {% endif %} {% ifversion fpt or ghec %} {% data reusables.organizations.user_must_accept_invite_email %} {% data reusables.organizations.cancel_org_invite %} {% endif %}