Add a custom domain

Custom domain is optional.

What is a custom domain?

As you already have a domain with ENS, adding a custom domain is optional. A custom domain allows you to display your space (and only your space) on a custom domain.

Create a pull request

To add a custom domain you need to do a pull request on this repository:

Follow the Snapshot spaces directory tree

└── spaces
└── domains.json

Add a custom domain

Set it in the Domain name field

To add a custom domain, fill in the Domain name field in your settings.
The domain name field in Snapshot settings.

Insert it in the domains.json file list

To add your subdomain to Snapshot, you need to edit the domains.json file below.
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.
"": "ens.eth",
"my.custom.url": "my-space.eth",
"": "ens.eth",

Configure your DNS

You will need to add this as CNAME in your domain DNS
After committing your PR, you will have to wait for the merge. This process can take a few hours.

Activate your custom domain

Once the PR is merged you can go here to activate the domain: (Replace "" with your custom domain).
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.
Under the current flow, we still have to merge a commit from our side to finalize the deployment of your PR to be able to get your domain live. This process can take up to a couple of days