Configuring DNS records

If you had a custom domain name assigned to your Bubble app prior to October 2019, you are considered a Legacy Customer.

If you have never assigned a custom domain to your Bubble app before, ignore the instructions marked for Legacy Customers.

There are three pieces to configuring a custom domain:

  1. Purchasing a custom domain at a registrar, such as NameCheap or DreamHost

  2. Registering your custom domain with Bubble, covered in Custom Domains and SSL

  3. Configuring your nameservers

There are two main kinds of domain: subdomains, of the form app.example.com; and www.example.com/example.com (which are handled identically).

(app.example.com)

If your custom domain is of the form app.example.com, you can register the custom domain in your Bubble app, in Settings -> Domain.

Bubble will instruct you to create two records at your registrar. The records will be of the form

Type: A Name: app Value: 104.xxx.xxx.xxx
Type: A Name: app Value: 104.xxx.xxx.xxx

These are provided for redundancy, but in most cases your custom domain will work identically with either or both.

You can enter these at your registrar:

Once Bubble and Cloudflare verify your domain has been updated, your custom domain will work!

(example.com) or (www.example.com)

Your users will generally expect to be able to load your domain on example.com andwww.example.com. For SEO purposes, we redirect exactly one of these to the other address.

For instance, if you enter example.com as your custom domain, we will automatically redirect www.example.com to example.com—as long as your DNS records are correct!

When you choose your custom domain, Bubble will instruct you to create four records at your registrar. The records will be of the form

Type: A Name: Value: 104.xxx.xxx.xxx
Type: A Name: Value: 104.xxx.xxx.xxx
Type: A Name: www Value: 104.xxx.xxx.xxx
Type: A Name: www Value: 104.xxx.xxx.xxx

These are provided for redundancy, but in most cases your custom domain will work identically with either or both, so long as you have at least one record for the bare domain and one for www.

See also: Frequently Asked Questions