Multi-org GA content

cloud-account/index.md

@@ -3,9 +3,9 @@ mapped_pages:
   - https://www.elastic.co/guide/en/cloud/current/ec-account-user-settings.html
   - https://www.elastic.co/guide/en/serverless/current/general-user-profile.html
 applies_to:
-  serverless: all
+  serverless: ga
   deployment:
-    ess: all
+    ess: ga
 products:
   - id: cloud-hosted
   - id: cloud-serverless
@@ -16,24 +16,37 @@ description: Manage your Elastic Cloud account settings, including email, passwo
 
 # Manage your Cloud account and preferences
 
+This section explains how to manage your {{ecloud}} account as a user, including your account settings, organizations, and interface preferences.
+
+::::{tip}
+This section covers only your personal account. Organization-wide settings, such as user permissions and organization-level access controls, are managed by organization administrators.
+
+For information on organization and access management, refer to:
+- [Manage your Cloud organization](/deploy-manage/cloud-organization.md)
+- [Manage user roles and permissions](/deploy-manage/users-roles/cloud-organization/user-roles.md)
+::::
+
+
+## Manage your account settings
+
 Your {{ecloud}} account allows you to manage your personal settings, including your email address, password, and authentication methods. You can perform the following tasks at any time from your user profile:
 
-* [Update your email address](/cloud-account/update-your-email-address.md)
-* [Add an additional login method](/cloud-account/add-a-login-method.md): Choose from password-based login, Google sign-in, and Microsoft sign-in.
+* [](/cloud-account/update-your-email-address.md)
+* [](/cloud-account/add-a-login-method.md): Choose from password-based login, Google sign-in, and Microsoft sign-in.
+
 
 If you use password-based login, then you can perform the following additional tasks:
 
-* [Change your password](/cloud-account/change-your-password.md)
-* [Configure multifactor authentication](/cloud-account/multifactor-authentication.md)
+* [](/cloud-account/change-your-password.md)
+* [](/cloud-account/multifactor-authentication.md)
 
-Additionally, you can manage your organization membership, including joining or leaving an organization. Refer to [Join or leave an organization](/cloud-account/join-or-leave-an-organization.md) for more information.
+## Manage your organizations
 
-Some options also let you set personal preferences and customize the interface, such as [using dark mode](dark-mode.md) in your projects and deployments.
+Organizations are groupings of {{ecloud}} resources and associated settings. As an {{ecloud}} user, you can be a member of multiple organizations.
 
-::::{tip}
-This section focuses on the actions you can take as an individual user to manage your own account. It does not cover organization-wide settings, such as managing user permissions or configuring organization-level access controls, which are handled by the organization administrators.
+* [](/cloud-account/join-or-leave-an-organization.md)
+* [](/cloud-account/switch-organizations.md)
 
-For information on organization and access management, refer to:
-- [Manage your Cloud organization](/deploy-manage/cloud-organization.md)
-- [Manage user roles and permissions](/deploy-manage/users-roles/cloud-organization/user-roles.md)
-::::
+## Customize your interface
+
+Some options also let you set personal preferences and customize the interface, such as [using dark mode](dark-mode.md) in your projects and deployments.

cloud-account/join-or-leave-an-organization.md

@@ -3,44 +3,56 @@
   - https://www.elastic.co/guide/en/cloud/current/ec-invite-users.html
   - https://www.elastic.co/guide/en/serverless/current/general-manage-organization.html
 applies_to:
-  serverless: all
+  serverless: ga
   deployment:
-    ess: all
+    ess: ga
 products:
   - id: cloud-hosted
   - id: cloud-serverless
 ---
 
 # Join or leave an organization
 
-Organizations in {{ecloud}} group user accounts, projects and deployments under a common billing and access structure. If you have been invited to an organization, you can accept the invitation and become a member. You can also leave an organization at any time, as long as you don’t have active projects or deployments associated with your account.
+Organizations in {{ecloud}} group user accounts, projects, and deployments under a common billing and access structure. If you have been invited to an organization, you can accept the invitation and become a member. You can join multiple organizations, or [create a new organization](/deploy-manage/cloud-organization/manage-multiple-organizations.md#create-a-new-organization).
 
-This guide explains how to join or leave an organization, including steps for handling projects and deployments when switching organizations.
+You can also leave an organization, with some restrictions. Refer to [Leave an organization](#ec-leave-organization) for details.
+
+This guide explains how to join or leave an organization. To learn how to view organizations you have access to and switch between them, refer to [](switch-organizations.md).
+
+:::{tip}
+If you're an organization owner or admin, refer to [](/deploy-manage/cloud-organization/manage-multiple-organizations.md) to learn how to manage multiple organizations.
+:::
 
 ## Accept an invitation [ec-accept-invitation]
 
-Invitations to join an organization are sent by email. Invited users have 72 hours to accept the invitation. If they do not join within that period, an administrator of the organization will have to send a new invitation. Refer to [manage users](/deploy-manage/users-roles/cloud-organization/manage-users.md) for more information.
+When you're invited to join an organization, you receive an email with a link to accept the invitation. Invitations expire after 72 hours. If you don't accept within that period, an administrator of the organization needs to send a new invitation. Refer to [manage users](/deploy-manage/users-roles/cloud-organization/manage-users.md) for more information.
 
-## Leave an organization [ec-leave-organization]
+To accept an invitation:
 
-On the **Members** tab of the **Organization** page, click the three dots corresponding to your email address and select **Leave organization**.
+1. Open the invitation email and click **Accept invitation**.
+2. Log in if prompted. If you already have an active session in your browser, you don't need to log in again.
+3. After accepting, you're switched to the new organization automatically. The new organization also appears in your [list of organizations](/cloud-account/switch-organizations.md).
 
-If you’re the only user in the organization, you can only leave if you deleted all your deployments and projects, and you don’t have pending bills.
+:::{note}
+If the organization enforces a specific login method, such as SAML SSO, you're redirected to that login flow when accepting the invitation.
+:::
+
+To decline an invitation, you can ignore the email. The invitation expires automatically after 72 hours.
+
+## Leave an organization [ec-leave-organization]
 
-## Join an organization from an existing {{ecloud}} account [ec-join-invitation]
+You can leave an organization at any time. If you are the only owner of an organization, you must transfer ownership before leaving.
 
-If you already belong to an organization, and you want to join a new one you will need to leave your existing organization and follow this steps:
+You can leave only the organization you're currently signed in to. To leave a different organization, [switch to it](/cloud-account/switch-organizations.md) first.
 
-1. Make sure you do not have active projects or deployments before you leave your current organization.
-2. Delete your projects or deployments and clear any bills.
-3. Leave your current organization.
-4. Ask the administrator to invite you to the organization you want to join.
-5. Accept the invitation that you will get by email.
+:::{warning}
+Leaving an organization revokes your access to all of its resources, including deployments, projects, and settings. This action cannot be undone. To rejoin the organization, ask an organization owner to invite you again.
+:::
 
-Alternatively, for Elastic Cloud Hosted deployments, there's a possibility to migrate your deployments to the new organization through back up and restore operations. In such case:
+To leave your current organization:
 
-1. [Back up your deployments to any private repository](/deploy-manage/tools/snapshot-and-restore/elastic-cloud-hosted.md) so that you can restore them to your new organization.
-2. Leave your current organization.
-3. Ask the administrator to invite you to the organization you want to join.
-4. Accept the invitation that you will get by email.
-5. Configure the private repository in your new organization and restore the backup you took in step 1.
+1. Log in to the [{{ecloud}} Console](https://cloud.elastic.co?page=docs&placement=docs-body).
+2. From the top navigation menu, click on the user menu and select **Profile**.
+3. Click the **My organizations** tab.
+4. Click **Leave current organization**.
+5. In the confirmation dialog, click **Leave current organization** to confirm.

cloud-account/multifactor-authentication.md

@@ -2,9 +2,9 @@
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud/current/ec-account-security-mfa.html
 applies_to:
-  serverless: all
+  serverless: ga
   deployment:
-    ess: all
+    ess: ga
 products:
   - id: cloud-hosted
 ---

cloud-account/switch-organizations.md

@@ -0,0 +1,45 @@
+---
+applies_to:
+  deployment:
+    ess: ga
+  serverless: ga
+products:
+  - id: cloud-hosted
+  - id: cloud-serverless
+navigation_title: View and switch between organizations
+description: Learn how to view all Elastic Cloud organizations you belong to, switch between them, and understand the login experience when you have multiple organizations.
+---
+
+# View and switch between {{ecloud}} organizations
+
+From a single {{ecloud}} account, you can access multiple organizations.
+
+You might be a member of multiple organizations in cases such as the following:
+
+* You use different organizations for different use cases or teams.
+* You're a consultant working with multiple clients who have different {{ecloud}} organizations.
+
+You can switch between organizations at any time. Depending on the organization that you're switching to, you might be required to re-authenticate.
+
+If you're an organization owner, then you can learn more about managing multiple organizations in [](/deploy-manage/cloud-organization/manage-multiple-organizations.md).
+
+:::{tip}
+To join an additional organization, [accept an invitation](/cloud-account/join-or-leave-an-organization.md#ec-accept-invitation) to join the organization. You can also [create a new organization](/deploy-manage/cloud-organization/manage-multiple-organizations.md#create-a-new-organization).
+:::
+
+:::{include} /deploy-manage/cloud-organization/_snippets/view-orgs.md
+:::
+
+:::{include} /deploy-manage/cloud-organization/_snippets/switch-orgs.md
+:::
+
+## Log in with multiple organizations
+
+When you belong to multiple organizations, the login experience depends on whether your browser has information about the organization you most recently used:
+
+* **Returning user (same browser):** You're automatically logged in to the organization you last used. You don't need to select an organization.
+* **New browser or cleared data:** After logging in, you're presented with a list of your organizations to choose from. Select the organization you want to access.
+
+If your last used organization enforces a specific login method (such as SAML SSO), you're directed to that login flow automatically.
+
+If you log out, your browser remembers which organization you last used. The next time you log in, you're directed to the appropriate login page for that organization.

cloud-account/toc.yml

@@ -6,5 +6,6 @@ toc:
   - file: change-your-password.md
   - file: add-a-login-method.md
   - file: multifactor-authentication.md
+  - file: switch-organizations.md
   - file: dark-mode.md
   - file: high-contrast.md

cloud-account/update-your-email-address.md

@@ -2,9 +2,9 @@
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud/current/ec-update-email-address.html
 applies_to:
-  serverless: all
+  serverless: ga
   deployment:
-    ess: all
+    ess: ga
 products:
   - id: cloud-hosted
 ---
@@ -13,8 +13,14 @@ products:
 
 Each {{ecloud}} account has a primary email associated with it. By default, the primary email address is used to sign up for {{ecloud}} and to log in. If needed, you can change this primary email address.
 
-Your email address is used to uniquely identify you. It can’t be used for more than one {{ecloud}} account, whether that account is a trial account, a standard {{ecloud}} account, or a subscription account through a marketplace. An {{ecloud}} account can belong to only one organization at a time.
-
+Your email address is used to uniquely identify you. It can’t be used for more than one {{ecloud}} account, whether that account is a trial account, a standard {{ecloud}} account, or a subscription account through a marketplace. However, a single {{ecloud}} account can belong to [multiple organizations](/cloud-account/switch-organizations.md).
+
+If you have separate {{ecloud}} accounts for different organizations and want to consolidate to a single account, ask an organization owner in each organization to [reconcile your accounts](/deploy-manage/cloud-organization/manage-multiple-organizations.md#reconcile-alternative-email-addresses).
+
+:::{note}
+If you belong to any organization that enforces a specific authentication method (such as SAML SSO, Google Sign-In, or Microsoft Sign-In), you can't change your primary email address using the procedures on this page. This restriction applies even if other organizations you belong to don't enforce a login method.
+:::
+
 ## Change your email address (native sign-in)
 
 If you log in using a standard email and password, follow these steps to update your email address:
@@ -35,16 +41,4 @@ If you log in using Google or Microsoft Sign-In, follow these steps to update yo
 
 ## Changing your email address with a Microsoft Marketplace account
 
-If your organization is associated with [Microsoft Marketplace](../deploy-manage/deploy/elastic-cloud/azure-native-isv-service.md), you can’t change your primary email address using the above methods. Instead, [invite another user](../deploy-manage/users-roles/cloud-organization/manage-users.md) with the desired email address to join your organization.
-
-## Sign up using an existing email address [sign-up-existing]
-
-In some situations, you might want to create a new {{ecloud}} account using an email address that is already associated with an existing account. To sign up to {{ecloud}} using an email address associated with another {{ecloud}} account, you must remove the email address from your previous account and replace it with a new address.
-
-1. Use your current email address (for example, `my.preferred.address@foobar.com`) to log in to the [{{ecloud}} Console](https://cloud.elastic.co?page=docs&placement=docs-body).
-2. Follow the steps from one of the procedures on this page to update that email address to another email address, such as `my.alternate.address@gmail.com`.
-
-You can now use the email address from step 1 to do the following:
-
-* [Sign up for a new account](/deploy-manage/deploy/elastic-cloud/create-an-organization.md).
-* [Join an existing organization](/cloud-account/join-or-leave-an-organization.md).
+If your organization is associated with [Microsoft Marketplace](../deploy-manage/deploy/elastic-cloud/azure-native-isv-service.md), you can’t change your primary email address using the above methods. Instead, [invite another user](../deploy-manage/users-roles/cloud-organization/manage-users.md) with the desired email address to join your organization.

deploy-manage/cloud-organization.md

@@ -11,9 +11,15 @@
 
 # Manage your Cloud organization [ec-organizations]
 
-When you [sign up for {{ecloud}}](/deploy-manage/deploy/elastic-cloud/create-an-organization.md), you create an organization. This organization is the umbrella for all of your {{ecloud}} resources, users, and account settings. Every organization has a unique identifier. 
+An organization is the umbrella for a group of {{ecloud}} resources, users, and account settings. Every organization has a unique identifier.
 
-You can perform the following tasks to manage your Cloud organization:
+When you [sign up for {{ecloud}}](/deploy-manage/deploy/elastic-cloud/create-an-organization.md), you have the option to create a new organization. You also can be [added to an existing organization](/deploy-manage/users-roles/cloud-organization/manage-users.md).
+
+The administrator of an organization is referred to as the organization owner, and belongs to the [Organization owner role](/deploy-manage/users-roles/cloud-organization/user-roles.md#ec_organization_level_roles). An organization can have more than one organization owner.
+
+## Organization management tasks
+
+As an organization owner, you can perform the following tasks to manage your Cloud organization:
 
 * [Manage billing](/deploy-manage/cloud-organization/billing.md)
 * Manage user access to your organization: 
@@ -23,10 +29,23 @@
   * [Configure SAML single sign-on](/deploy-manage/users-roles/cloud-organization/configure-saml-authentication.md) to your organization
 * [Manage API keys](/deploy-manage/api-keys.md) to use with the [{{ecloud}}]({{cloud-apis}}), [{{ecloud}} Billing]({{cloud-billing-apis}}), and [{{serverless-full}}]({{cloud-serverless-apis}}) APIs. For {{serverless-full}} projects, you can also create {{ecloud}} API keys that grant access to project-level {{es}} and {{kib}} APIs.
 * Configure who receives [operational emails](/deploy-manage/cloud-organization/operational-emails.md) related to your organization
-* Track the [status of {{ecloud}} services](/deploy-manage/cloud-organization/service-status.md).
+* Track the [status of {{ecloud}} services](/deploy-manage/cloud-organization/service-status.md)
 
 Several aspects of your organization can also be managed using tools provided by Elastic. For a list of tools, refer to [{{ecloud}} organization tools and APIs](/deploy-manage/cloud-organization/tools-and-apis.md).
 
 ::::{tip} 
 To learn how to manage your {{ecloud}} account as a user, refer to [Manage your Cloud account](/cloud-account/index.md).
 ::::
+
+## Managing multiple organizations
+
+You can create or access multiple organizations from a single {{ecloud}} account. 
+
+You might want to create multiple organizations for reasons such as the following:
+
+* You want to separate management of your {{ecloud}} resources and settings for different use cases or teams.
+* You want to create a [trial](/deploy-manage/deploy/elastic-cloud/create-an-organization.md#general-sign-up-trial-what-is-included-in-my-trial) to evaluate additional {{ecloud}} features or solutions.
+
+Each organization has its own set of resources, users, settings, and billing and licensing.
+
+You need to be logged in to the organization you want to manage to make changes to its resources and settings. [Learn how to manage multiple organizations](/deploy-manage/cloud-organization/manage-multiple-organizations.md).

deploy-manage/cloud-organization/_snippets/switch-orgs.md

@@ -5,4 +5,8 @@ You can switch between organizations at any time. Depending on the authenticatio
 1. Log in to the [{{ecloud}} Console](https://cloud.elastic.co?page=docs&placement=docs-body).
 2. From the top navigation menu, click on the user menu and select **Profile**.
 3. Click the **My organizations** tab.
-4. Click the name of the organization you want to switch to. If it doesn't appear in the list, click **Manage organizations** to view all of the organizations you have access to.
+4. Click the name of the organization you want to switch to. If it doesn't appear in the list, click **Manage organizations** to view all of the organizations you have access to.
+
+:::{tip}
+You can also switch organizations from the breadcrumbs at the top of any page. Click your current organization name and select another organization from the list.
+:::