Add a custom domain
Learn what a custom domain is and how to set it up for your space.
Last updated
Learn what a custom domain is and how to set it up for your space.
Last updated
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.
You cannot create a custom domain through Snapshot. Make sure that you own the custom domain before setting it up.
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.
Update your DNS settings on the custom domain provider dashboard and set CNAME to:
cname.snapshot.org
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.
Create a fork of the snapshot-spaces Github repository:
Follow the Snapshot spaces directory tree and open the domains.json file.
Add the mapping for your custom domain and Snapshot space in the following format:
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.
Create a Pull Request on the original snapshot-spaces repository with the above changes.
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.
It can take the team around 72 hours to merge your Pull Request, so please be patient
That's all! You should now be able to use the custom domain for your space \