Adding a domain to a site

This guide walks through attaching a domain you already own to a SuperSpace site, pointing your DNS at us, and letting SuperSpace provision an SSL certificate automatically. By the end, visitors will reach your site over HTTPS at your own domain instead of the temporary SuperSpace URL.

Steps

1. Open the site's Domains page. In the left sidebar, open My Sites and select the site you want to use. In the site's sidebar, choose Domains. The page is headed Domain Management.

2. Start adding a domain. Click Add Domain. The first domain you add fills the Primary Domain table; any later ones are added as Domain Aliases (additional domains pointed at the same site).

3. Enter the domain. In the Domain field, type the registrable domain you want to use (for example example.com), then click Continue. SuperSpace checks the domain and shows you the next step based on what it finds.

   Note

   Enter the apex domain, not a subdomain. A leading www. is dropped automatically (so www.example.com is treated as example.com), and any other subdomain (such as blog.example.com) is rejected.

4. Choose how to connect it. What SuperSpace shows next depends on what its check found for that domain:

   • Already in your SuperSpace workspace — you'll see "example.com is already in your workspace" with a Connect domain button. Connecting it points the existing DNS zone at this site.

     Warning

     Connecting a domain that already has a DNS zone in your workspace overwrites the existing DNS records on that zone. You'll be asked to confirm before it proceeds.

   • Available to register — you'll see a "Register example.com" offer with a Register this domain button (and the registration price). This domain isn't registered anywhere yet, so the DNS-pointing options below don't appear — register it first (see Purchasing a domain), and it will then be in your workspace.

   • Registered elsewhere — you'll see a "Transfer example.com to your account" offer with a Transfer this domain button. If you'd rather keep the domain at your current registrar, skip the transfer and continue to the next step to point the existing domain at SuperSpace instead.

   The Confirm DNS Settings for New Domain options in the next step appear for a domain registered elsewhere (and stay available even if the domain can't be transferred). They don't appear for a domain that's available to register or one already in your workspace.

5. Point your DNS at SuperSpace (registered-elsewhere domains). Use one of these two methods from the Confirm DNS Settings for New Domain screen:

   • Nameservers (recommended). Under Update Domain Name Servers (Recommended), set your domain's nameservers at your registrar to the two shown on screen, then click Create Domain. The exact nameservers are listed on screen — they're specific to your account, so use the values shown rather than any from this guide. Using SuperSpace nameservers lets us manage the full DNS zone for you.

   • CNAME (keep DNS at your current provider). Open Alternate Method: Create a CNAME, add a CNAME record for your domain pointing to the target shown on screen, then click Create using the alternate CNAME method.

     Warning

     If your DNS is on Cloudflare, do not enable the orange-cloud proxy on this record. Leave it set to DNS only, or certificate issuance and origin routing will fail.

6. Wait for provisioning. Adding a domain runs asynchronously — SuperSpace creates a background task and returns you to the Domain Management page, where the new domain appears with a status. The domain's status updates as the work completes.¹

SuperSpace automatically generates your SSL certificate once it detects the correct DNS settings, so once your nameserver or CNAME change has propagated, the certificate is issued without any further action. Watch the domain's Status on the Domain Management page to follow progress.

Adding a domain with the API

You can create the domain and poll the returned task instead of using the dashboard. provision_method must be the exact string dns to provision via nameservers; any other value (or omission) is treated as cname:

curl -X POST \
  -H "Authorization: Bearer $SUPERSPACE_TOKEN" \
  -H "X-Auth-Account: $ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","provision_method":"dns"}' \
  https://control.superspace.nl/api/sites/$SITE_ID/domains

The call returns 202 and a task you can poll until it completes. For the full request/response shape, promotion, and removal, see Domains.

Pre-issuing an SSL certificate (optional)

If you want a valid certificate before you switch traffic to your domain — to avoid any HTTPS gap during the cutover — you can pre-issue one using a DNS-01 challenge. This is available once the site's CDN is active and no certificate has been issued yet.

1. On the Domain Management page, click Pre-issue SSL next to the domain.

2. Click Request certificate. SuperSpace generates a TXT record (a Name and a Value) for you to copy.

3. Add that TXT record at your DNS provider, then click Verify & complete. There's no automatic polling — click verify once the record is live. When it validates, the panel shows Certificate issued.

Managing the domain afterward

• Once a domain has a SuperSpace DNS zone, a Manage button appears next to it for editing DNS records. See Managing DNS.
• To switch which domain is primary, use Make Primary on an alias.
• Delete removes a domain from the site; if you delete the primary domain, the site falls back to its temporary SuperSpace URL. Promote a replacement to primary before deleting the old one.

Next steps

• Point or edit your records in Managing DNS
• Don't own the domain yet? Purchase a domain
• Automate it with the Domains API