Change organization URL

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.

If you're using Zulip Cloud (E.g. https://example.zulipchat.com), you can request a change by emailing support@zulip.com. Custom domains (i.e. those that do not have the form example.zulipchat.com) have a maintenance cost for our operational team and thus are only available for paid plans.

Self-hosting

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 follow these steps:

  1. Get the string_id for your organization as described here

  2. Run the following commands in a management shell:

    realm = get_realm("string_id")
    do_change_realm_subdomain(realm, "new_subdomain")