Connect a custom domain to your Bubble app with a full DNS setup walkthrough covering CNAME records, www vs non-www redirects, SSL certificates, and troubleshooting common DNS propagation issues. This tutorial guides you through every step from purchasing a domain to seeing it live on your Bubble app.
Overview: Using Custom Domains in Bubble
By default, Bubble apps live at yourapp.bubbleapps.io. A custom domain like yourapp.com makes your app look professional. This tutorial covers purchasing a domain, configuring DNS records, setting up redirects, and troubleshooting SSL issues.
Prerequisites
- A Bubble app on the Starter plan or higher
- A domain name purchased from a registrar (Namecheap, GoDaddy, Google Domains, etc.)
- Access to your domain registrar's DNS settings
- Basic understanding of what DNS records are
Step-by-step guide
Add your custom domain in Bubble settings
Add your custom domain in Bubble settings
In your Bubble editor, go to Settings in the left sidebar, then the Domain/email tab. In the Domain section, enter your custom domain (e.g., www.yourapp.com). Click the Add domain button. Bubble will display the required DNS records you need to configure at your registrar.
Expected result: Bubble shows the DNS records (CNAME) you need to add at your domain registrar.
Configure DNS records at your registrar
Configure DNS records at your registrar
Log into your domain registrar (Namecheap, GoDaddy, etc.). Navigate to DNS Management. Add a CNAME record: Host = www, Value = the CNAME target Bubble provided (typically yourapp.bubbleapps.io). For the root domain (yourapp.com without www), some registrars support ALIAS or ANAME records pointing to Bubble's target. If not, use a redirect from root to www.
Pro tip: Set the TTL (Time To Live) to 300 seconds (5 minutes) during setup so changes propagate faster. Increase it later for caching.
Expected result: DNS records are configured pointing your domain to Bubble's servers.
Set up root domain redirect
Set up root domain redirect
If your registrar does not support ALIAS records for the root domain, set up a redirect from yourapp.com to www.yourapp.com. Most registrars offer URL forwarding in their DNS settings. Choose a 301 (permanent) redirect. This ensures users who type yourapp.com without www are sent to the correct address.
Expected result: Visiting yourapp.com redirects to www.yourapp.com where your Bubble app is served.
Wait for DNS propagation and verify
Wait for DNS propagation and verify
DNS changes can take 15 minutes to 48 hours to propagate globally. Use a tool like dnschecker.org to verify your CNAME record is resolving correctly. In Bubble's Settings, click the Check DNS button to verify. Once Bubble confirms the DNS is correct, it will automatically provision an SSL certificate.
Expected result: DNS resolves correctly and Bubble provisions an SSL certificate for your domain.
Troubleshoot common issues
Troubleshoot common issues
If you see SSL errors, check that you are not using Cloudflare proxy mode (use DNS-only/gray cloud instead). If the domain does not resolve, verify the CNAME record has no typos and TTL has elapsed. If you see ERR_CERT_INVALID, wait 15 more minutes for the SSL certificate to provision. For SSL_ERROR_BAD_CERT_DOMAIN, ensure the domain in Bubble settings matches exactly what you configured in DNS.
Expected result: All DNS and SSL issues are resolved and your app loads on the custom domain with HTTPS.
Complete working example
1CUSTOM DOMAIN SETUP — CHECKLIST2================================34STEP 1: BUBBLE SETTINGS5 Settings → Domain/email → Add domain6 Enter: www.yourapp.com7 Note the CNAME target provided89STEP 2: DNS RECORDS10 At your registrar's DNS management:11 Record 1 (CNAME):12 Host: www13 Value: yourapp.bubbleapps.io (or Bubble's provided target)14 TTL: 3001516 Record 2 (Root domain — if ALIAS supported):17 Host: @ (or blank)18 Type: ALIAS or ANAME19 Value: yourapp.bubbleapps.io2021 OR: URL redirect from yourapp.com → www.yourapp.com (301)2223STEP 3: VERIFICATION24 Wait 15 min - 48 hours for propagation25 Check at dnschecker.org26 In Bubble: Settings → Check DNS2728STEP 4: SSL29 Automatic after DNS verification30 Wait up to 15 min for certificate3132TROUBLESHOOTING33 Cloudflare: Use DNS-only mode (gray cloud)34 SSL error: Wait for certificate provisioning35 Domain not resolving: Check CNAME spelling36 ERR_CERT_INVALID: Allow more propagation timeCommon mistakes when using custom domains in Bubble
Why it's a problem: Using Cloudflare proxy mode instead of DNS-only
How to avoid: Set your DNS record to DNS-only mode (gray cloud icon) in Cloudflare's dashboard.
Why it's a problem: Adding an A record instead of CNAME
How to avoid: Always use a CNAME record pointing to the hostname Bubble provides, not an IP address.
Why it's a problem: Not setting up the root domain redirect
How to avoid: Set up a 301 redirect from the root domain to www, or use an ALIAS record if your registrar supports it.
Best practices
- Use CNAME records instead of A records for reliability
- Set up redirects so both www and non-www versions work
- Start with low TTL (300 seconds) during setup, increase later
- Disable Cloudflare proxy if using Cloudflare for DNS
- Test your domain on multiple browsers after setup
- Verify SSL is working by checking for the padlock icon
Still stuck?
Copy one of these prompts to get a personalized, step-by-step explanation.
I want to connect my custom domain to my Bubble.io app. Walk me through the DNS configuration, CNAME setup, www vs non-www redirect, and SSL troubleshooting.
Help me set up my custom domain. I need to configure DNS records at my registrar, add the domain in Bubble settings, and ensure SSL works correctly.
Frequently asked questions
Do I need a paid Bubble plan for custom domains?
Yes. Custom domains are available on the Starter plan ($29/month) and above. Free plans use the bubbleapps.io subdomain.
How long does DNS propagation take?
Typically 15 minutes to 2 hours, but can take up to 48 hours in rare cases. Use dnschecker.org to monitor progress.
Can I use a subdomain like app.mysite.com?
Yes. Add a CNAME record for the subdomain (e.g., Host: app, Value: yourapp.bubbleapps.io) and add app.mysite.com in Bubble settings.
Will my old bubbleapps.io URL still work?
Yes. The bubbleapps.io URL continues to work alongside your custom domain. Bubble does not automatically redirect from one to the other.
Can I use multiple custom domains?
Bubble supports one primary custom domain per app. For additional domains, set up redirects at the registrar level pointing to your primary domain.
Can RapidDev help with domain and deployment setup?
Yes. RapidDev can handle DNS configuration, SSL troubleshooting, CDN setup, and multi-domain architecture for your Bubble apps.
Talk to an Expert
Our team has built 600+ apps. Get personalized help with your project.
Book a free consultation