---
title: How to move a domain between Vercel projects with "Zero Downtime"?
description: Information about how to move your domain between Vercel projects without downtime.
url: /kb/guide/how-to-move-a-domain-between-vercel-projects-with-zero-downtime
canonical_url: "https://vercel.com/kb/guide/how-to-move-a-domain-between-vercel-projects-with-zero-downtime"
published: 2025-11-03
last_updated: 2025-11-10
authors: Holden Altaffer
related:
  - /docs/cli
  - /docs/concepts/deployments/automatic-urls
  - /docs/rest-api
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---
<!-- docsgraph:related -->
## Related pages

> **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below.

- [Transferring Domains](https://vercel.com/docs/domains/working-with-domains/transfer-your-domain?from=related) — Domains can be transferred to another team or project within Vercel, or to and from a third-party registrar. Learn how t
- [Deploying & Redirecting Domains](https://vercel.com/docs/domains/working-with-domains/deploying-and-redirecting?from=related) — Learn how to deploy your domains and set up domain redirects with this guide.
- [Move a project domain](https://vercel.com/docs/rest-api/projects/move-a-project-domain?from=related)
- [Transferring a project](https://vercel.com/docs/projects/transferring-projects?from=related) — Learn how to transfer a project between Vercel teams.
- [vercel alias](https://vercel.com/docs/cli/alias?from=related) — Learn how to apply custom domain aliases to your Vercel deployments using the vercel alias CLI command.
- [How can I move a domain to a Vercel team?](https://vercel.com/kb/guide/how-can-i-move-a-domain-to-a-team?from=related) — Information on how to move domains between accounts on Vercel.
- [How can I migrate a site to Vercel without downtime?](https://vercel.com/kb/guide/zero-downtime-migration?from=related) — Information about how to assign a Vercel deployment to a domain without downtime.
- [How can I do a "Zero Downtime" DNS migration to Vercel?](https://vercel.com/kb/guide/zero-downtime-migration-for-dns?from=related) — Information about how to migrate your DNS records to Vercel without downtime.
- [How do I add a custom domain to my Vercel project?](https://vercel.com/kb/guide/how-do-i-add-a-custom-domain-to-my-vercel-project?from=related) — Learn how to add a custom domain to your Vercel project.
- [How do I resolve alias related errors on Vercel?](https://vercel.com/kb/guide/how-to-resolve-alias-errors-on-vercel?from=related) — Information on resolving alias related errors on Vercel.

Full cross-link map for this page: [/kb/guide/how-to-move-a-domain-between-vercel-projects-with-zero-downtime.graph.md](/kb/guide/how-to-move-a-domain-between-vercel-projects-with-zero-downtime.graph.md)
<!-- /docsgraph:related -->


It is possible with Vercel to move a custom domain between projects without downtime.

## Alias the Domain to New Project

Using the [Vercel CLI](https://vercel.com/docs/cli#commands/alias) command `vercel alias`, it is possible to alias the custom domain to another Vercel project's Deployment, even though the domain is already assigned to a project. You can run the following command:

```bash
vercel alias set [deployment-url-on-new-project] [custom-domain]
```

Make sure to use the [Automatic URL](https://vercel.com/docs/concepts/deployments/automatic-urls) for the `[deployment-url-on-new-project]` parameter (e.g. `[<project-name>-<unique-hash>-<scope-slug>.vercel.app]`). Also, make sure to **not** include the HTTP protocol (e.g. `https://`) for the `[custom-domain]` parameter. ✅ `vercel alias set hotdog-8jk8-coolcat.vercel.app sillyhotdog.im` ❌ `vercel alias set hotdog-8jk8-coolcat.vercel.app https://sillyhotdog.im` ## Assigning the Domain to New Project With your custom domain aliased to the new target Deployment, you may now visit the original project's **Domain** settings. Under the domain tab, remove the domain. Under the new project's **Domain** settings, you may now add the domain, along with any redirects and Git branch assignments. ## Using the Vercel API Alternatively, it is possible to move a custom domain between projects with the Vercel API. This method may be quicker to perform however a brief period of downtime is likely to occur between the execution of the [removal](https://vercel.com/docs/rest-api#endpoints/projects/remove-a-domain-from-a-project) and [addition](https://vercel.com/docs/rest-api#endpoints/projects/add-a-domain-to-a-project) API calls.