Skip to main content

Adding organizations to your enterprise

You can add organizations to manage within your enterprise by creating a new organization, inviting an existing organization, or transferring an organization from a different enterprise account.

Who can use this feature

Enterprise owners can add organizations to an enterprise.

About addition of organizations to your enterprise account

Your enterprise account can own organizations. Members of your enterprise can collaborate across related projects within an organization. For more information, see "About organizations."

You can add new organizations to your enterprise account. If you do not use Enterprise Managed Users, you can add existing organizations on GitHub.com to your enterprise. You cannot add an existing organization from an enterprise with managed users to a different enterprise.

If you currently use GitHub Enterprise Cloud with a single organization, we encourage you to create an enterprise account. For more information, see "Creating an enterprise account."

After you add an existing organization to your enterprise, the organization's resources remain accessible to members at the same URLs, and the following changes will apply.

  • The organization's members will become members of the enterprise, and GitHub will bill the enterprise account for the organization's usage. You must ensure that the enterprise account has enough licenses to accommodate any new members. For more information, see "About billing for your enterprise."

  • Enterprise owners can manage their role within the organization. For more information, see "Managing your role in an organization owned by your enterprise."

  • Any policies applied to the enterprise will apply to the organization. For more information, see "About enterprise policies."

  • If SAML SSO is configured for the enterprise account, the enterprise's SAML configuration will apply to the organization. If the organization used SAML SSO, the enterprise account's configuration will replace the organization's configuration. SCIM is not available for enterprise accounts, so SCIM will be disabled for the organization. For more information, see "Configuring SAML single sign-on for your enterprise" and "Switching your SAML configuration from an organization to an enterprise account."

  • If SAML SSO was configured for the organization, members' existing personal access token or SSH keys that were authorized to access the organization's resources will be authorized to access the same resources. To access additional organizations owned by the enterprise, members must authorize the personal access token or key. For more information, see "Authorizing a personal access token for use with SAML single sign-on" and "Authorizing an SSH key for use with SAML single sign-on."

  • If the organization was connected to GitHub Enterprise Server or GitHub AE using GitHub Connect, adding the organization to an enterprise will not update the connection. GitHub Connect features will no longer function for the organization. To continue using GitHub Connect, you must disable and re-enable the feature. For more information, see the following articles.

  • If the organization used billed GitHub Marketplace apps, the organization can continue to use the apps, but must pay the vendor directly. For more information, contact the app's vendor.

  • Any coupons will be removed from the organization. To reapply the coupon, contact our sales team.

Creating an organization in your enterprise account

New organizations you create within your enterprise account settings are included in your enterprise account's GitHub Enterprise Cloud subscription.

Enterprise owners who create an organization owned by the enterprise account automatically become organization owners. For more information about organization owners, see "Roles in an organization."

  1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises. "Your enterprises" in drop-down menu for profile photo on GitHub Enterprise Cloud

  2. In the list of enterprises, click the enterprise you want to view. Name of an enterprise in list of your enterprises

  3. On the Organizations tab, above the list of organizations, click New organization. New organization button

  4. Under "Organization name", type a name for your organization. Field to type a new organization name

  5. Click Create organization.

  6. Under "Invite owners", type the username of a person you'd like to invite to become an organization owner, then click Invite. Organization owner search field and Invite button

  7. Click Finish.

Inviting an organization to join your enterprise account

Enterprise owners can invite existing organizations to join their enterprise account. If the organization you want to invite is already owned by another enterprise account, you must be an owner of both enterprise accounts, or the previous enterprise must give up ownership of the organization first. For more information, see "Removing an organization from your enterprise."

  1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises. "Your enterprises" in drop-down menu for profile photo on GitHub Enterprise Cloud

  2. In the list of enterprises, click the enterprise you want to view. Name of an enterprise in list of your enterprises

  3. On the Organizations tab, above the list of organizations, click Invite organization. Invite organization

  4. Under "Organization name", start typing the name of the organization you want to invite and select it when it appears in the dropdown list. Search for organization

  5. Click Invite organization.

  6. The organization owners will receive an email inviting them to join the enterprise. At least one owner needs to accept the invitation before the process can continue. You can cancel or resend the invitation at any time before an owner approves it. Cancel or resend

  7. Once an organization owner has approved the invitation, you can view its status in the list of pending invitations. Pending invitation

  8. To complete the transfer, click Approve. Approve invitation

Transferring an organization between enterprise accounts

Enterprise owners can transfer existing organizations between enterprise accounts. You must be an enterprise owner of both enterprise accounts.

Note: You cannot transfer an existing organization to or from an enterprise with managed users.

  1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises. "Your enterprises" in drop-down menu for profile photo on GitHub Enterprise Cloud

  2. In the list of enterprises, click the enterprise you want to view. Name of an enterprise in list of your enterprises

  3. Next to the organization you want to transfer, select the dropdown, and then click Transfer organization. Screenshot of the transfer button

  4. Select the Select enterprise dropdown menu, start typing the name of the destination enterprise, and select the enterprise when it appears in the dropdown list. Screenshot of the enterprise dropdown

  5. Click Review transfer.

  6. To confirm the transfer, click Transfer organization. Screenshot of the transfer organization button