Overview

You want to set up a custom sub/domain for your Progressive Web App (PWA) so you can choose the URL used for your app. This article shows how you can achieve that once you have configured a CNAME entry/record in your DNS.

Diagnosis

You need to add a custom sub/domain for your PWA to use so that your app will be not using the default PWA URL (its status format is: https://webapp.mobileappco.org/m/{appcode}).

Having already set up the domain of your preference will help you promote and advertise your brand and make your PWA more Search Engine Optimization friendly.

Back to the top

Prerequisites

You should have already set up the entry in DNS (Domain Name System) for the Custom Domain following the guidelines detailed below. 

• The entry MUST be a CNAME pointing to webapp.pwahosting.com. "ALIAS" records do not currently work. This means the entry must be a subdomain.

  For example, www.biznessapps.com is a subdomain of the root domain biznessapps.com.

• The name must be compliant with RFC 952. Only numbers, letters, and the hyphen ("-") are allowed. Underscores are not allowed.

• The DNS provider must have CAA lookups implemented.

Notes:

•  If you don't have a custom domain configured, you can check the Setting up a GoDaddy Subdomain KB article.
• We strongly recommend using the customer's domain, rather than the reseller's domain or a new domain. This is the best practice in terms of search results.

Back to the top

Solution 

1. Go to Settings > Domain & SEO > Web App Domain. and click Add.
   
   

2. In the pop-up, type in the new domain and click Validate. This checks that the Domain has been correctly set up. If it fails to validate, the domain may not yet have propagated throughout  the global Domain Name System, or the CNAME may not be pointing at webapp.pwahosting.com.
   
   

Note:  If you wish to check that your existing domain is working as expected, use the DNS Propagation Checker  

3. If the validation is successful, click Add again to add the domain.

4. Wait up to one business day for a verification email:

• Single Clients: You will receive an email when the site is set up.
• Partners: The email is sent from your Partner Support Email to the Client Email in the "Edit Info" section of the application. Contact Bizapps Support to change your Partner Support Email address.

Notes:

• Editing a domain will not cause any problem on iOS and Android Publishing as this concerns the PWA (Progressive Web App).
• When changing the domain of a PWA, it could take up to one business day for the change to take place. During this time, the PWA will be accessible via the White Label URL:
  
  https://webapp.mobileappco.org/m/{appcode}
{appcode} = App code of the app
  
  

You can also review the video below that outlines the procedure of setting up a custom domain for a PWA.

Back to the top

Testing

To check the recently updated domain, go back to Settings > Domain & SEO > Web App Domain. 

• If the setup is not completed, you will see: Setup in progress...
  
  
  
  
• Once the Domain setup is completed, it will display as per the image below.
  
  

Back to the top

Related Articles

• Search Engine Optimization (SEO) For a PWA
• Setting up a Godaddy Subdomain