Connect a custom domain

bookmark_border Stay organized with collections Save and categorize content based on your preferences.

You don't have to give up your unique, brand-centric domain names for apps deployed on Firebase App Hosting. You can use a custom domain (like example.com or app.example.com) instead of a Firebase-generated domain for your Firebase-hosted site. Firebase App Hosting provisions an SSL certificate for each of your domains.

The rest of this document walks you through the steps to connect a custom domain in one of these ways:

• Migrate a domain
• Connect a new domain

To ensure uninterrupted service, your DNS records must be updated in a certain order. Follow the instructions to migrate a domain to prevent downtime for your app.

If downtime isn't a concern, such as when you are connecting a domain that is new to your web app, follow the instructions to connect a new domain.

Before you begin: DNS record types

The App Hosting Set up domain wizard could ask you to add or remove 1 to 5 DNS records, depending on your domain's current configuration. A record's Type determines its function. These are the types of records App Hosting might ask for:

Before you begin: your custom domain name

When adding or editing DNS records, different domain providers expect you to enter different inputs for the Host (or host name) field within their DNS management sites. The App Hosting custom domain wizard requires you to input this same value in the Name field.

We've compiled common inputs from popular providers below. Refer to your domain provider's documentation for detailed instructions.

Common domain providers

Here are some common domain providers and the types of input each might require. This information is kept up-to-date as much as possible, but refer to your domain provider's documentation for detailed instructions.

Cloudflare

Host	Input
example.com.	@
www.example.com.	www

Google Cloud DNS

Host	Input
example.com.	.example.com.
www.example.com.	www.example.com.

NameCheap

Host	Input
example.com.	@
www.example.com.	www

Squarespace

Host	Input
example.com.	@
www.example.com.	www

Migrate a domain

If you want to ensure uninterrupted service without any downtime for your app, you must set up your DNS records in a certain order. After adding your domain, you'll first work through a process to verify your DNS records, and then you'll perform one more verification step to direct live requests to App Hosting.

Step 1: Add custom domain

1. Open your project's App Hosting page.
2. Select an App Hosting backend using the View Dashboard option.
3. Select the Settings tab, then click Add custom domain.
4. Enter the custom domain name that you'd like to connect to your App Hosting site.
5. (Optional) Check the box to redirect all requests on the custom domain to a second specified domain (such that example.com and www.example.com redirect to the same content).
6. Click Continue to setup to configure your DNS records and finish setting up your custom domain.

Step 2: Verify DNS records

1. 1. The Migrate a domain wizard of the Firebase console will show the necessary records that need to be updated to point your page to Firebase App Hosting. Add, remove, and save records from your domain in your DNS provider with the following inputs for the required records:
   • Name: Enter your custom domain name for the records. The host you indicate is the domain on which you want to serve content; this domain can be an apex domain or subdomain. Your domain provider may list this term as "Host Name", "Name", or "Domain"
   • Record type: Add the provided DNS record.
   • Value: Assign the provided value to your records. Your domain provider may list this term as "Data", "Points To", "Content", "Address", or "IP Address". The content of the value field varies by record type, with A and AAAA records having IP addresses as values while TXT records are strings.
2. Select Verify records. App Hosting will attempt to detect the changes you have main in your domain provider. It can take up to 24 hours for changes to propagate. You can check the status in the Settings > Domains view in the backend dashboard.

Step 3: Direct to App Hosting

1. After App Hosting verifies the record updates, the Direct to App Hosting dialog displays the final record you must update to direct your domain to App Hosting. As before, add, remove, and save records from your domain in your DNS provider with the following inputs for the required records:
   • Name: Enter your custom domain name for the records. The host you indicate is the domain on which you want to serve content; this domain can be an apex domain or subdomain. Your domain provider may list this term as "Host Name", "Name", or "Domain"
   • Record type: Add the provided DNS record.
   • Value: Assign the provided value to your records. Your domain provider may list this term as "Data", "Points To", "Content", "Address", or "IP Address". The content of the value field varies by record type, with A and AAAA records having IP addresses as values while TXT records are strings.
2. Select Verify records. App Hosting will attempt to detect the changes you have main in your domain provider. It can take up to 24 hours for changes to propagate. You can check the status in the Settings > Domains view in the backend dashboard.

Connect a new Domain

If downtime isn't a concern, such as when you are connecting a domain that is new to your web app, follow the instructions in this section.

Step 1: Add custom domain

1. Open your project's App Hosting page.
2. Select an App Hosting backend using the View Dashboard option.
3. Select the Settings tab, then click Add custom domain.
4. Enter the custom domain name that you'd like to connect to your App Hosting site.
5. (Optional) Check the box to redirect all requests on the custom domain to a second specified domain (such that example.com and www.example.com redirect to the same content).
6. Click Continue to setup to configure your DNS records and finish setting up your custom domain.

Step 2: Verify DNS records

1. The Set up domain wizard of the Firebase console will show the necessary records that need to be updated to point your page to Firebase App Hosting. Add, remove, and save records from your domain in your DNS provider with the following inputs:
   • Name: Enter your custom domain name for the records. The host you indicate is the domain on which you want to serve content; this domain can be an apex domain or subdomain. Your domain provider may list this term as "Host Name", "Name", or "Domain"
   • Record type: Add the provided DNS record.
   • Value: Assign the provided value to your records. Your domain provider may list this term as "Data", "Points To", "Content", "Address", or "IP Address". The content of the value field varies by record type, with A and AAAA records having IP addresses as values while TXT records are strings.
2. Select Verify records. App Hosting will attempt to detect the changes you have main in your domain provider. It can take up to 24 hours for changes to propagate. You can check the status in the Settings > Domains view in the backend dashboard.

Wait for SSL certificate provisioning

App Hosting can take up to a few hours to provision an SSL certificate for your domain after you update your DNS records. In some cases, it could require up to 24 hours after you point your DNS to Firebase App Hosting.

You can view this certificate using the browser's security tools. While the domain is provisioning, you might see an invalid certificate or have issues connecting to your domain. This is a normal part of the process and will resolve after your domain's certificate is available.

Note: Firebase App Hosting automatically reprovisions SSL certs, as needed, for custom domains.

Status descriptions for custom domains