Change organization URL

This feature is only available to organization owners.

Zulip supports changing the URL for an organization. Changing the organization URL is a disruptive operation for users:

  • Users will be logged out of existing sessions on the web, mobile and desktop apps and need to log in again.
  • Any API clients or integrations will need to be updated to point to the new organization URL.

We recommend using a wildcard mention in an announcement stream to notify users that they need to update their clients.

Change your Zulip Cloud subdomain

Zulip Cloud organizations are generally hosted at <subdomain>.zulipchat.com, with the subdomain chosen when the organization was created. Organization owners can request to change the subdomain.

Please e-mail support@zulip.com with the following information:

  1. Your organization's current subdomain.

  2. The subdomain you would like to move your organization to.

Move to a custom URL on Zulip Cloud

Zulip Cloud customers who wish to use this feature must upgrade to the Zulip Cloud Plus plan.

Because maintaining custom URLs requires effort from our operational team, this feature is available only for organizations with 25+ Zulip Cloud Plus licenses.

Please e-mail support@zulip.com with the following information:

  1. Your organization's current URL.

  2. The URL you would like to move your organization to.

Change the URL for your self-hosted server

If you're self-hosting, you can change the root domain of your Zulip server by changing the EXTERNAL_HOST setting. If you're hosting multiple organizations and want to change the subdomain for one of them, you can do this using the change_realm_subdomain management command.

In addition to configuring Zulip as detailed here, you also need to generate SSL certificates for your new domain.