> ## Documentation Index
> Fetch the complete documentation index at: https://www.spacebring.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom domain for member web portal

> Step-by-step instructions to set up a custom third-level domain for your member web portal and troubleshoot custom domain configuration issues

## What is a custom third-level domain

A custom third-level domain is a unique branded name that identifies a website. For example, `members.coworkingspace.com` or `residents.coworkingspace.com` are custom domains for the coworking space app. For this, it's enough to create a subdomain using a domain you already own. Some common choices for the subdomain to use:

* members
* portal
* community
* residents
* app
* www

![Set up a custom domain on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/JwOrgJXc3yW3FLb3/images/member-web-portal-manage-a-custom-third-level-domain-for-your-member-web-portal-1.png?fit=max\&auto=format\&n=JwOrgJXc3yW3FLb3\&q=85\&s=9b26b03883b4ffee3f9bb07a98bbf531)

## Set up a custom domain

> [!WARNING]
>
> The member web portal works only on a third-level domain, such as `members.coworkingspace.com`. You can't set it up on your root domain, such as `coworkingspace.com`.

**1. Add a CNAME record in your domain registrar**

1. Log in to your domain registrar account and open its DNS control panel.
2. Create a new record with the following data:

| **Type** | CNAME |
| - | - |
| **Name** | your subdomain, for example `members`, `app` or `community` |
| **Value** | `cname.spacebring.com` |
| **TTL** | leave the default value |

Instructions for common registrars:

* [GoDaddy](https://www.godaddy.com/help/add-a-cname-record-19236?)
* [Google Domains](https://support.google.com/domains/answer/3251147?hl=en#zippy=%2Ccname)
* [Namecheap](https://www.namecheap.com/support/knowledgebase/article.aspx/9646/2237/how-to-create-a-cname-record-for-your-domain)
* [WordPress](https://wordpress.com/support/domains/connect-subdomain/#connecting-your-subdomain-to-an-external-site)
* [WIX](https://support.wix.com/en/article/adding-or-updating-cname-records-in-your-wix-account)
* [Webflow](https://university.webflow.com/lesson/connect-a-custom-domain)
* [Squarespace](https://support.squarespace.com/hc/en-us/articles/360002101888-Adding-custom-DNS-records-to-your-Squarespace-managed-domain)

**2. Add the custom domain in Spacebring**

1. An [owner or super administrator](https://www.spacebring.com/docs/administration/administrators.md#understand-administrator-roles) goes to **Network settings** > **Member web portal** > **General** tab.
2. Enter your full custom third-level domain in the **Custom domain** field, such as `members.coworkingspace.com`.
3. If a **Verification** section appears, add its record to your DNS settings as well.

![Custom domain field on the Member web portal settings page on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/JwOrgJXc3yW3FLb3/images/member-web-portal-manage-a-custom-third-level-domain-for-your-member-web-portal-2.png?fit=max\&auto=format\&n=JwOrgJXc3yW3FLb3\&q=85\&s=75f0cbdf80c233887485963f81d5e179)

**3. Verify the setup**

Enter your custom domain, such as `members.coworkingspace.com`, in your browser's address bar. When the setup is complete, your member web portal opens.

* Once DNS records have been changed, they can take some time to propagate, which means global DNS providers recognize they have been changed. A CNAME record usually propagates within minutes, but DNS changes can take up to 48 hours.
* Spacebring checks the record every hour. Until it detects the record, the custom domain stays unverified, and the **DNS configuration** section shows the record to add.
* To check the progress, click **Check propagation** in the **DNS configuration** section.

## Migrate the domain name to a different hosting provider

If you are changing the hosting provider, you need to make the following changes to your currently configured custom domain to ensure having the same domain:

1. Go to the DNS panel of your new hosting provider and [create a record](#set-up-a-custom-domain) for a custom domain on the new hosting site.
2. Delete the previously created DNS records on the old hosting site.

## Change the domain name

If you're changing your domain name, you need to follow these steps:

1. Open the DNS panel of your hosting provider and [create a new record](#set-up-a-custom-domain) for your new domain.
2. Add a new record to Spacebring on **Network settings** > **Member web portal** > **General** tab > **Custom domain** field.
3. Delete an old record created for the old domain.

## Troubleshoot issues with custom domain

When Spacebring detects a problem with your CNAME record, it notifies you. If your custom domain worked before, it waits until three hourly checks in a row fail, so a short outage at your domain provider doesn't trigger a false alert. You see the problem in these places:

* A banner on the left-side panel says "The member web portal needs a CNAME record to work."
* The **DNS configuration** section on the **Member web portal** page says "We couldn't detect the CNAME record. Please verify it was added correctly in your DNS settings, or allow time for changes to propagate."
* If your custom domain worked before, owners get an "Issue detected with your custom domain" email.

> [accordion] 1. Your record is still propagating
>
> If you recently added or changed your CNAME record, it can take up to 48 hours to propagate. Your member web portal may already open at your custom domain in your country or region, but not yet in others.
>
> To see where your record is already visible:
>
> 1. Go to **Network settings** > **Member web portal** > **General** tab.
> 2. In the **DNS configuration** section, click **Check propagation**.

> [accordion] 2. Your domain provider has a temporary issue
>
> Your domain provider may have a temporary outage that stops your custom domain from working. Open your member web portal at your custom domain to check whether it works again. If it still doesn't, contact your domain provider.

> [accordion] 3. The CNAME record has wrong settings
>
> In your domain's DNS panel, compare the record's **Type**, **Name**, and **Value** with the table in [Set up a custom domain](#set-up-a-custom-domain), and correct any that differ.

> [accordion] 4. The Custom domain field in the admin dashboard doesn't match your record
>
> 1. Go to **Network settings** > **Member web portal** > **General** tab.
> 2. Check that the **Custom domain** field has your record's full domain, such as `members.coworkingspace.com`.
> 3. If the field is empty or has a different domain, enter the right one.

When Spacebring detects your record, the banner and the warning disappear, and owners get a "Your custom domain issue is resolved" email.

## FAQs

> [accordion] Why doesn't my custom domain work?
>
> Learn more about potential causes in the [Troubleshoot issues with custom domain](#troubleshoot-issues-with-custom-domain) section above.

> [accordion] Can I use my root domain, such as coworkingspace.com?
>
> No. The member web portal works only on a third-level domain, such as `members.coworkingspace.com`. You can set up the portal on the `www` subdomain, such as `www.coworkingspace.com`. If you want members who type `coworkingspace.com` to reach the portal, you can redirect your root domain to `www.coworkingspace.com` in your domain registrar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.