Tutorial
2 min read

Use an existing domain

Seamlessly integrate your existing domain with Vercel. Maximize flexibility and maintain your established online presence.
Table of Contents

Use this snippet to add a domain that you own to a Vercel project:

terminal
vercel domains add [domain] [project]

Already have a domain you love? Seamlessly integrate it with Vercel to leverage the platform's powerful features and infrastructure. Whether you're migrating an existing project or want to maintain your established online presence, you can use the steps below to add your custom domain.

  1. Go to your project's domains settings

    Select your project and select the Settings tab. Then, select the Domains menu item.

  2. Add your existing domain to your project

    From the Domains page, enter the domain you wish to add to the project.

    Connecting your Git provider and creating a new repository
    Connecting your Git provider and creating a new repository
    Connecting your Git provider and creating a new repository
    Connecting your Git provider and creating a new repository

    If you add an apex domain (e.g. example.com) to the project, Vercel will prompt you to add the wwwsubdomain prefix, the apex domain, and some basic redirection options.

    For more information on which redirect option to choose, see Redirecting www domains.

  3. Configure your DNS records

    Configure the DNS records of your domain with your registrar so it can be used with your Project. The dashboard will automatically display different methods for configuring it:

    Instructions on configuring an apex domain from the Project Domains page.

    • If the domain is in use by another Vercel account, you will need to verify access to the domain, with a TXT record
    • If you're using an Apex domain (e.g. example.com), you will need to configure it with an A record
    • If you're using a Subdomain (e.g. docs.example.com), you will need to configure it with a CNAME record

    Both apex domains and subdomains can also be configured using the Nameservers method. Wildcard domains must use the nameservers method for verification. For more information see Add a custom domain.

Next, learn how to take advantage of Vercel's collaboration features as part of your developer workflow:

Last updated on May 18, 2024