What You Will Do
If your site is already live on its Filebase subdomain, the next step is making it feel like yours. This tutorial shows how to connect a domain you already own to your Filebase Site so visitors can reach it from your branded URL instead of the default Filebase address.
Along the way, you will use the exact labels shown in the dashboard and the DNS record Filebase provides, so you can move through the setup without guessing what to click or what value to copy.
Before You Start
- Your static site should already be created in Filebase and loading on its Filebase subdomain.
- You need access to your DNS provider or domain registrar.
- Custom domains are a paid feature. On free plans, the dashboard shows Upgrade now to unlock Custom Domains.
Open the Site and Start the Flow
In the Filebase dashboard, open Sites, click the site you want to update, and stay on the Overview page. In the top-right action bar, click Add Custom Domain.
The modal is tied to the site you opened, so the DNS target it shows is already specific to that site.
Enter the Domain
In the modal, type your domain into Custom Domain Name. In most cases, that will be something like www.yourdomain.com. As you type, the DNS example updates live.
The record Filebase asks you to create follows this pattern:
your-domain.example CNAME your-site-subdomain.<filebase-sites-domain>.Replace your-domain.example with the domain you typed into the form, and replace your-site-subdomain.<filebase-sites-domain> with the exact Filebase target shown in the modal for your site.
Create the DNS Record
Leave the Filebase modal open and log in to your DNS provider in another tab. Create a CNAME record using the exact values shown by Filebase:
- Host / Name: the custom domain or hostname you entered in Filebase.
- Type:
CNAME. - Target / Value: your site’s Filebase subdomain shown in the modal.
Filebase validates the domain when you save it, so create the DNS record first and give it a few minutes to propagate before you come back.
Save the Domain in Filebase
Go back to Filebase after saving the DNS change and wait a few minutes. Then click Add Custom Domain in the modal.
On save, Filebase checks whether your domain resolves to the site subdomain. If DNS is not live yet, the request can fail with a validation error. In that case, wait a bit longer and try again.
Confirm It Worked
After the update succeeds, stay on the site’s Overview page and look at the Custom Domain row in the Site Overview table. Your domain should now appear there as a clickable link.
You will also still see the Filebase-provided Subdomain URL in the same table, which is useful for testing and fallback access.
Troubleshooting
- Submitting the Filebase form before the DNS record exists.
- Pointing the domain at the wrong Filebase site subdomain.
- Adding the wrong host in your registrar instead of the exact custom hostname you want to use.
- Trying this on a free plan, where the UI only shows the upgrade prompt.