Skip to main content

Bubble.io Custom Domains & Whitelabelling

This guide shows, step by step, how to connect a branded domain to your Bubble application

Drago Crnjac avatar
Written by Drago Crnjac
Updated over a week ago

1. Create the upstream for your Bubble app

What’s an upstream?

An upstream is the place where your Bubble app already runs—myapp.bubbleapps.io, app.myproduct.com, and so on.
SaaS Custom Domains proxies traffic from every custom domain you attach and forwards it to this upstream.

  1. In the dashboard click Create Upstream

  2. Host – paste the full hostname of your Bubble app, e.g. app.myproduct.com

  3. Enable the Bubble.io checkbox so we know your app is on Bubble.io

  4. Click Create Upstream.

You’ll land on the upstream’s detail page.

You are now ready to attach custom domains to the upstream.

2. Add a custom domain

  1. Inside the upstream page, click Add Custom Domain.

  2. Host – the exact domain or sub-domain your customer wants, e.g. store.client.com.

  3. (Optional) Set the Bubble Target Path, e.g. /stores/client.

  4. Click Create Custom Domain.

What is Bubble Target Path?

This is the homepage on the Bubble app that should be loaded when someone visits the custom domain, e.g., if your custom domain is store.client.com and your Bubble app page is app.myproduct.com/stores/client, you would enter /stores/client here. Now anyone visiting store.client.com would actually see whatever is behind app.myproduct.com/stores/client.

Once you created your custom domain, you'll see it in the domain list.

Click on the View Instructions badge in the Proxy column to see the instructions for the DNS record you need to add.


Once you add this DNS record, this badge will turn green. Please note, it may take a few minutes for the DNS records to become fully visible.

That's it! Your custom domain is ready to go!

Want to fine-tune SEO, favicons, and social cards? Read the Bubble Settings guide.


Need more help? Reach out via the Intercom chat widget and we'll be right with you!

Did this answer your question?