Delete or Reset Tenants
If you want to completely remove an unwanted tenant, we recommend deleting it. This option is useful if you have created a test or demo tenant that you won't be using again, so you don't care about keeping your tenant name.
If you want to keep using your tenant name, we recommend resetting your tenant by using the Deploy CLI Tool to remove any unwanted items. This will return your tenant to its initial state and retain your tenant name.
This process deletes only one tenant. If you have other tenants that need to be removed, you will need to repeat these steps for each tenant. If you are an enterprise customer or have a paid subscription, please review our caveats before proceeding.
- Log in to the Dashboard.
- Click on your username in the top right corner to display the dropdown box.
- Select Settings to open the Tenant Settings page.
- On the Tenant Settings page, select the Advanced tab.
- Scroll down to the Danger Zone at the bottom of the page, and click Delete.
For enterprise customers
If you are an Enterprise customer, you may have multiple child tenants as part of your Auth0 contract. While it is not possible to delete the main tenant from the dashboard (you will need to contact support for that), the child tenants can be deleted at any time. Rest assured that if you choose to delete a child tenant, this will have no impact on your agreement with Auth0. We recommend speaking with your Technical Account Manager if you have any concerns about your Enterprise agreement.
For paid subscription customers
If you have a paid subscription with one or more child tenants, deleting the main subscription is not possible from the Dashboard. Please contact support for that. It is possible to delete child tenants from the Dashboard, and deleting such tenants should have no impact on your subscription plan. This is because activity and usage on child tenants counts toward the main tenant's activity and usage limitations.
To reset your tenant to its initial state, you can use the Deploy CLI Tool. This creates a "clean" environment for development or test purposes and removes unwanted items.
Install the tool
a0deployby running the following in your command-line interface:
npm i -g auth0-deploy-cli
Get a snapshot of the state you would like to preserve:
a0deploy export --config_file config.json --format yaml --output_folder ./
Update the configuration file used for the import.
Update your tenant with its stored state:
a0deploy import --config_file config.json --format yaml --input_file ./tenant.yaml
- If you've deleted your tenant, and you require the use of a particular domain name, we recommend configuring a custom domain name for your new tenant.
- Cancel Your Auth0 Subscription to downgrade to a free account.
- Change or Upgrade Your Auth0 Subscription
- Update a Tenant Admin to change ownership of the tenant.
- Export Data Out of Auth0
- Reset Your Auth0 Account Password