DEV Community

Cover image for How to do Subdomain URL Redirects with Vercel Hosting

Posted on • Originally published at

How to do Subdomain URL Redirects with Vercel Hosting

I remember the first time my friend Ash showed me Vercel (at the time it named Now / Zeit). I was blown away. Since then, I’ve been using it to host my personal blog and personal website - both domains.

One of the things I’ve been meaning to do over the past year is create subdomains for quick branded forwarding to different websites. There isn’t a straightforward tutorial on how to do this, so here we go!

What you’ll need

  • Vercel Account
  • Github Account
  • Custom Domain

This tutorial assumes you’ve already purchased your custom domain, and are managing it via Vercel. If this is not the case, please check out this document on custom domains on Vercel.

In this project, I will show you how I created a redirect for the subdomain,, to my Twitch channel - I actually wrote this blogpost live on my stream, using an Oculus Rift! I've included a clip of it below.

To write this blog post, I refered to this Github issue that was opened on Vercel's repo by SeinopSys.

  1. Create a basic GitHub repo for the domain
    It's the basic page for creating a new repo on github

    it's the basic github page after a new repo has been created

  2. Initialize the project locally - it won’t need much in it.

  3. Create a document in the local folder called vercel.json - this is the only file you will need for redirects.

    terminal command line touch vercel.json

  4. In vercel.json, add the following code:

        "redirects": [
            { "source": "/", "destination": "[](" }

    This JSON object says that every-time the ‘/’ domain is visited, Vercel will redirect the visitor to the destination URL. I wanted all visitors of the page to be immediately redirected to my twitch channel hence, "destination":"".

  5. Commit code to the Github
    terminal with code being commited to a github repo

  6. Run the vercel command in your terminal to create a new vercel project. Make sure it’s a new project, not linked to any pre-existing project

  7. Run vercel --prod to push your website live.

    terminal showing project being deployed to vercel and to prod

    At this point, your redirect will be live, but not have the proper domain. In the next steps, we will set up the domain.

  8. Go to your Vercel Dashboard ui (online, click into the project)
    dashboard of the live ali dev project

  9. Connect your Github repo to your project by clicking:

    dashboard of vercel project showing the git integrations

    We are connecting the project to the Github repo, because Vercel has it such that every time a commit is made to your repo, it’ll update the website. This makes it easier to update the URL as needed.

  10. Next, click into settings > domains

    dashboard showing the vercel project domains that are available

  11. Add the domain you want to redirect - for the subdomain, you can just type in the subdomain. The main domain should be maintained / controlled by the Vercel name servers. Click here to learn how to set that up.
    dashboard showing the successful successful setting of the domain for the vercel project

  12. Congrats you now have a domain redirect!

Go forth and redirect all the pages!

Bonus Video

This was originally posted on my personal blog, If you want to watch the bonus YouTube video, you'll need to check it out over there ;)

Top comments (0)