Checklist for setting up a new domain

This is a checklist of how to set up a new domain in Adobe Commerce on cloud infrastructure.

Affected products and versions

Adobe Commerce on cloud infrastructure, all supported versions

How to set up a new domain

Step 1 - Is this for the Integration, Staging, or Production environment?

• Integration: Custom domains are not supported. You must use this method instead: Set up multiple websites or stores: Configure local installation in our user guide.
• Staging: Go to Step 2.
• Production: Go to Step 3.

Step 2 - Staging environment: are you on Pro or Starter?

• Pro: Submit a request to add the domain to Fastly, Nginx, and configure the SSL certificate (as well as the Sendgrid domain, if necessary). Once that has been configured, update the DNS configuration with development settings.

• Starter: Custom domains are not supported.

Step 3 - Production environment: are you on Pro or Starter?

• Pro: Submit a request to add the domain to Fastly, Nginx, and configure the SSL certificate (as the Sendgrid domain, if necessary). Once that has been configured, continue to Step 4.

• Starter: Add the domain to your project in the Domains tab, then submit a request to provide the ACME Challenge Key for the SSL certificate.

Step 4 - Is the domain live?

• YES: Update the DNS configuration with production settings.
• NO: Update the DNS configuration with development settings.

Related reading

• Set up multiple websites or stores: Add New Domains in our user guide.