# Can I rename my deployment or organization? (/help-center/can-i-rename-my-deployment-or-organization)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 911 · updated: 2026-09-23 -->

Some names in Mintlify can be changed at any time and others are fixed when they are created:

* **Changeable**: your organization's name, your deployment's name, your docs site name in `docs.json`, and your custom domain.
* **Fixed**: your deployment's subdomain and your organization's slug. Changing either requires deleting and recreating.

## Rename your deployment [#rename-your-deployment]

The deployment name is the display name shown in the dashboard topbar. To change it:

1. Go to the [General settings](https://app.mintlify.com/settings/deployment/general) page in your dashboard.
2. In the **Deployment name** field, enter the new name. Names must be 3 to 100 characters and contain only letters, numbers, hyphens, and underscores.
3. Save your changes.

Renaming the deployment requires permission to update the deployment. If the field is disabled, contact an admin of your organization. See [Roles and permissions](/dashboard/roles).

## Change your deployment's subdomain [#change-your-deployments-subdomain]

Your subdomain identifies your deployment. It appears in your `<subdomain>.mintlify.app` URL and in your dashboard URL, `app.mintlify.com/<org>/<subdomain>`. The subdomain cannot be changed after the deployment is created.

To use a different subdomain, create a new deployment with the name you want, then delete the old one:

1. Create a new deployment connected to the same repository.
2. If you use a custom domain, remove it from the old deployment, then add it to the new deployment. See [Custom domain](/customize/custom-domain).
3. Delete the old deployment from the **Danger zone** section of the [Organization](https://app.mintlify.com/settings/organization/general) settings page. See [Delete a deployment](/deploy/deployments#delete-a-deployment).

<Warning>
  Deleting a deployment is permanent and removes all deployment data, including analytics history and any associated preview deployments. Dashboard settings do not transfer to the new deployment, so reconfigure them after you create it.
</Warning>

## Rename your organization [#rename-your-organization]

The organization name is the workspace display name shown across the dashboard. To change it:

1. Go to the [Organization general settings](https://app.mintlify.com/settings/organization/general) page in your dashboard.
2. In the **Name** field under **Workspace**, enter the new name.
3. Select **Save**.

Renaming the organization requires permission to update the organization. If the field is disabled, contact an admin of your organization. See [Roles and permissions](/dashboard/roles).

## Change your organization's slug [#change-your-organizations-slug]

Your organization's slug is the unique identifier that appears in your dashboard URL, `app.mintlify.com/<org>/<subdomain>`. The slug cannot be changed after the organization is created. To use a different slug, create a new organization, recreate your deployments in it, and delete the old organization from the **Danger zone** section of the [Organization](https://app.mintlify.com/settings/organization/general) settings page. Deleting an organization is irreversible and requires the [admin role](/dashboard/roles).

## What your readers see [#what-your-readers-see]

Your subdomain and organization name are rarely visible to readers, so you may not need to rename anything:

* The site name displayed on your docs comes from the [`name` field](/organize/settings-reference#name) in `docs.json`. You can change it at any time.
* The URL readers visit can be a [custom domain](/customize/custom-domain) like `docs.example.com`, which you can add or change at any time.