Sign in to your Google Cloud account. If you're new to
Google Cloud,create an accountto evaluate how our products perform in
real-world scenarios. New customers also get $300 in free credits to
run, test, and deploy workloads.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Clicking this button enables multi-tenancy and opens theTenantspage.
You are now ready to create your first tenant.
Creating a tenant
Open the Identity PlatformTenantspage in the Google Cloud console. Go to the Tenants page
ClickAdd tenant.
Enter aNamefor the tenant. This does not need to be
unique; Identity Platform will automatically assign a distinct ID.
ClickSave.
Congratulations! You've created an Identity Platform tenant.
Selecting a tenant
Use the drop-down menu in the top-left corner to switch between tenants.
Each tenant has its own providers, settings, and users. After you've selected a
tenant, you can manage it the same way you manage a non-tenant
Identity Platform project.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eEnable multi-tenancy for Identity Platform by clicking "Allow tenants" in the Security tab of the Identity Platform Settings page.\u003c/p\u003e\n"],["\u003cp\u003eCreate a new tenant by navigating to the Tenants page, clicking "Add tenant", and entering a name, then saving.\u003c/p\u003e\n"],["\u003cp\u003eSwitch between tenants using the drop-down menu located in the top-left corner of the console.\u003c/p\u003e\n"],["\u003cp\u003eEach tenant operates independently with its own providers, settings, and users, enabling you to manage each one separately.\u003c/p\u003e\n"],["\u003cp\u003eDisable multi-tenancy using the Identity Toolkit API.\u003c/p\u003e\n"]]],[],null,["# Set up multi-tenancy\n====================\n\nLearn how to enable [multi-tenancy](/identity-platform/docs/multi-tenancy)\nfor Identity Platform, and create a new tenant using the Google Cloud console.\n\n*** ** * ** ***\n\nTo follow step-by-step guidance for this task directly in the\nGoogle Cloud console, click **Guide me**:\n\n[Guide me](https://console.cloud.google.com/freetrial?redirectPath=/?walkthrough_id=identity-platform--multi-tenancy-quickstart)\n\n*** ** * ** ***\n\nBefore you begin\n----------------\n\n- Sign in to your Google Cloud account. If you're new to Google Cloud, [create an account](https://console.cloud.google.com/freetrial) to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\nEnabling multi-tenancy\n----------------------\n\n1. Open the Identity Platform **Settings** page in the Google Cloud console. \n\n [Go to the Settings page](https://console.cloud.google.com/customer-identity/settings)\n\n2. Click the **Security** tab.\n\n3. Click **Allow tenants** at the bottom of the page.\n\nClicking this button enables multi-tenancy and opens the **Tenants** page.\n\nYou are now ready to create your first tenant.\n\nCreating a tenant\n-----------------\n\n1. Open the Identity Platform **Tenants** page in the Google Cloud console. \n\n [Go to the Tenants page](https://console.cloud.google.com/customer-identity/tenants)\n\n2. Click **Add tenant**.\n\n3. Enter a **Name** for the tenant. This does not need to be\n unique; Identity Platform will automatically assign a distinct ID.\n\n4. Click **Save**.\n\nCongratulations! You've created an Identity Platform tenant.\n\nSelecting a tenant\n------------------\n\nUse the drop-down menu in the top-left corner to switch between tenants.\n\nEach tenant has its own providers, settings, and users. After you've selected a\ntenant, you can manage it the same way you manage a non-tenant\nIdentity Platform project.\n\nDisabling multi-tenancy\n-----------------------\n\nUse the [Identity Toolkit API](/identity-platform/docs/reference/rest/v2/projects/updateConfig) to disable multi-tenancy.\n\nWhat's next\n-----------\n\n- [Sign in users with tenants](/identity-platform/docs/multi-tenancy-authentication)\n- [Create a sign-in page for multiple tenants](/identity-platform/docs/multi-tenancy-ui)\n- [Migrate existing users to a tenant](/identity-platform/docs/migrate-users-between-projects-tenants)\n- [Manage tenants programmatically](/identity-platform/docs/multi-tenancy-managing-tenants)"]]
