Add a custom domain

Learn what a custom domain is and how to set it up for your space.

What is a custom domain?

Custom domain is a unique branded domain name which you can use for your space instead of using the default Snapshot's URL. The displayed website is exatly the same, the only difference being the address you can see in the browser. Have a look at the example below:

Snapshot URL: https://snapshot.org/#/balancer.eth

Custom domain: https://vote.balancer.fi/#/

As you already have a domain with ENS, adding a custom domain is optional.

Add a custom domain to your space

You cannot create a custom domain through Snapshot. Make sure that you own the custom domain before setting it up.

1. Update space settings

Head to your space settings on Snapshot and fill in the custom domain name field. It must match the one you added in the Pull Request.

The domain name field in Snapshot settings.

2. Configure your DNS

Update your DNS settings on the custom domain provider dashboard and set CNAME to:

cname.snapshot.org

3. Activate your domain

Use the below link to activate the domain: (make sure to replace <YOUR_DOMAIN_NAME_HERE> with your domain)

https://ina9pk8175.execute-api.us-west-2.amazonaws.com/dev?domain=<YOUR_DOMAIN_NAME_HERE>

If your domain name is example.com then URL will look like this

Note that at this step the returned message could contain warnings, this could happen if the domain DNS zone is not fully resolved yet or if you've already successfully activated your domain. The bottom line is if you've setup the CNAME record correctly you should not worry at all.

4. Fork the snapshot-spaces repository

Create a fork of the snapshot-spaces Github repository:

https://github.com/snapshot-labs/snapshot-spaces

5. Add your custom domain to domains.json

Follow the Snapshot spaces directory tree and open the domains.json file.

└── spaces
    └── domains.json

Add the mapping for your custom domain and Snapshot space in the following format:

"my.custom.url": "my-space.eth"

To prevent conflicts, it is recommended to add your subdomain between two existing domains rather than at the end or beginning of the list, as in the example below.

{
  ...
  "other.domain.com": "ens.eth",
  "my.custom.url": "my-space.eth",
  "other.domain.com": "ens.eth",
  ...
}

6. Create a pull request

Create a Pull Request on the original snapshot-spaces repository with the above changes.

It can take the team around 72 hours to merge your Pull Request, so please be patient 🙏

Once the PR is merged you will have to wait for the release of a new version on https://snapshot.org. It can take up to a couple of days. Once the new version is released, your space will be accessible from your custom domain.

That's all! You should now be able to use the custom domain for your space 🎉\