Skip to content

[ZT] Added how to change a team domain name #23909

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 11, 2025
Merged

[ZT] Added how to change a team domain name #23909

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f82fb27
Added how to change a team domain name
dcpena Jul 23, 2025
50e1094
add additional details
ranbel Jul 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 17 additions & 1 deletion src/content/docs/cloudflare-one/applications/configure-apps/dash-sso-apps.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ sidebar:
order: 4
---

import { FeatureTable, APIRequest } from "~/components";
import { FeatureTable, APIRequest, GlossaryTooltip } from "~/components";

By adding a Cloudflare Dashboard SSO application to your Cloudflare Zero Trust account, you can enforce single sign-on (SSO) to the Cloudflare dashboard with the identity provider (IdP) of your choice. SSO will be enforced for every user in your email domain.

Expand Down Expand Up @@ -214,3 +214,19 @@ curl --request PATCH \
```

Users can now log in using their Cloudflare account email and password. To re-enable SSO, send a `PATCH` request with `"sso_connector_status" : "V"`.

## Change your team name

Cloudflare does not allow you to change your <GlossaryTooltip term="team name">team name</GlossaryTooltip> while dashboard SSO is enabled. To change your team name, you must first disable dashboard SSO.

:::caution
Before disabling SSO, make sure you have access to your Cloudflare account email. This will allow you to reset your password in case you get logged out of the Cloudflare dashboard.
:::

1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Settings** > **Authentication**.
2. If SSO is enabled, turn off **Cloudflare dashboard SSO**. This action can only be performed by Super Administrators.
3. Go to **Settings** > **Custom Pages**.
4. Under **Team domain**, select **Edit** to enter the new team name. Select **Save**.
5. In your identity provider, update your Cloudflare integration with the new team name. For example, if you are using a SAML IdP, you will need to update the Single Sign-on URL and Entity ID to `https://<new-team-name>.cloudflareaccess.com/cdn-cgi/access/callback`.
6. In Zero Trust, go to **Settings** > **Authentication**.
7. Turn on **Cloudflare dashboard SSO** to re-enable SSO.
2 changes: 1 addition & 1 deletion src/content/docs/cloudflare-one/faq/getting-started-faq.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Your team domain is a unique subdomain assigned to your Cloudflare account, for
| ---------------- | --------------------------------------- |
| `your-team-name` | `<your-team-name>.cloudflareaccess.com` |

You can change your team name at any time, unless you have the Cloudflare dashboard SSO feature enabled on your account. Cloudflare dashboard SSO does not currently support team name changes.
You can change your team name at any time, unless you have the Cloudflare dashboard SSO feature enabled on your account. If Cloudflare dashboard SSO is enabled, you must [turn off SSO](/cloudflare-one/applications/configure-apps/dash-sso-apps/#change-a-team-name) before changing your team name.

:::caution[Warning]

Expand Down
8 changes: 1 addition & 7 deletions src/content/glossary/cloudflare-one.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -217,13 +217,7 @@ entries:

- term: team name
general_definition: |-
the customizable portion of your team domain, allowing you to personalize your Cloudflare Zero Trust configuration. You can view your team name in Zero Trust under **Settings** > **Custom Pages**.

| team domain | team name |
| --------------------------------------- | ---------------- |
| `<your-team-name>.cloudflareaccess.com` | `your-team-name` |

To learn about the consequences of changing your team name, refer to the [FAQ](/cloudflare-one/faq/teams-getting-started-faq/#whats-a-team-domainteam-name).
the customizable portion of your team domain (`<your-team-name>.cloudflareaccess.com`). You can view your team name in Zero Trust under **Settings** > **Custom Pages**.

- term: Terraform
general_definition: |-
Expand Down
Loading