How to use Handshake names

A walkthrough for using Handshake top-level domains

Redirect your name

Find your Handshake name in the Domain Manager, select "Manage", and fill out the "Namebase nameserver DNS records" section as shown in the table below.

Replace "SUBDOMAIN" and "URL" in the following example and be sure to include the "https://" part for your URL.

Namebase nameserver DNS records









Your URL will now be accessible via your Handshake name at: "SUBDOMAIN.TLD/", and can be accessed without any DNS configuration at "".

Create a Handshake site

You will need a GitHub account to create a Handshake website through Vercel or GitHub Pages. If you have not done so, please first sign up here.


Replace "SUBDOMAIN" in the following instructions with your desired subdomain, and "EXAMPLE" with your Handshake TLD name.

In the gifs, SUBDOMAIN: "home" and EXAMPLE: "johnnywu".

Sign up on Vercel with Github, import a new project with a template, and install Vercel on Github.

Create your public Github repository and add your full Handshake URL as a new domain (www.SUBDOMAIN.EXAMPLE or SUBDOMAIN.EXAMPLE).

Go to your Handshake name via the Domain Manager and create a new CNAME record in the Namebase nameserver DNS records section with Name: "www.SUBDOMAIN" and Value/Data: "". If you decided to omit the "www" and just use "SUBDOMAIN.EXAMPLE", then instead of CNAME you'll need to add an A type record with "" as the IP address.

Terminal method

Go to your Github repository, select Clone or download, and copy the link.

The rest of the steps will all be done through your Terminal.

git clone
open -a TextEdit pages/index.js

This will open up your Handshake page's .js file for editing. Once you've saved your changes, proceed with the following lines to update your page.

git add .
git commit -m "First edit"
git push origin master

Edit on GitHub

You can also just edit your website's code directly on GitHub.

GitHub Pages

Replace "EXAMPLE" in the following instructions with your Handshake name

  1. Create a new GitHub repository and name it "".

  2. In the Settings tab under the "GitHub Pages" section, click "Choose a theme" and select a theme.

  3. Go back to the "GitHub Pages" section to input "home.EXAMPLE" as your "Custom domain" and save.

  4. Now find your Handshake name in the Domain Manager, select "Manage", and "Add a new record" under the "Namebase nameserver DNS records" section with the following inputs: CNAME (Type); home (Name); (Value/data). Remember to save your settings.

Step 1: Create a new repository
Step 2: Select a theme
Step 3: Input your Handshake domain
Step 4: Change DNS records

Sell your name

Find your Handshake name in the Domain Manager, select "Manage", and click the slider next to "Sell this domain" to set your name's "Buy now price" and list it for sale.

You can edit your listings' Buy now prices or remove them altogether in your Domain Manager's for sale page.

Gift your name

Find your Handshake name in the Domain Manager, select "Manage", and select "Gift this domain". Make sure the email address of your recipient is the same as their Namebase account's. If the recipient doesn’t have a Namebase account, they’ll be prompted to create one when they claim their name.

And here's what it will look like from the recipient's point-of-view:


Share a screenshot of your resolvable Handshake domain in the Namer Community to earn the <Creator> role.