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.
In the dashboard click Create Upstream
Host – paste the full hostname of your Bubble app, e.g.
app.myproduct.com
Enable the Bubble.io checkbox so we know your app is on Bubble.io
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
Inside the upstream page, click Add Custom Domain.
Host – the exact domain or sub-domain your customer wants, e.g.
store.client.com
.(Optional) Set the Bubble Target Path, e.g.
/stores/client
.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!