Overview

You can create a custom subdomain of a domain you control for your Progressive Web App (PWA), this custom URL can use your branding and improve your SEO. To set up this customization you need to have access to the DNS records of your root or base domain, to configure the CNAME record and point it to our servers.

After this change, you will be able to use both our default white-labeled PWA URL https://webapp.mobileappco.org/m/{appcode}, and your own custom URL to reach your app.

Important:

Back to the top

Prerequisites

• You have an active PWA published in our CMS Panel.
• You have access to the DNS configuration of your root or base domain.
• 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.
• If you are a Partner/Reseller, we strongly recommend using your customer's domain, rather than your domain or a new domain. This is the best practice in terms of search results.

Back to the top

Solution 

You should 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.

• As the domain owner, you are responsible for acquiring an SSL Certificate for your root or base domain if you want to access it via HTTPS, e.g. example.com. As part of setting up a custom PWA subdomain, we will generate and update the SSL Certificate for the custom subdomain, e.g. app.example.com.
  For example, if you own example.com, and configure your PWA to the subdomain app.example.com, you will be able to access https://app.example.com as we generated that certificate, but without a proper certificate for example.com, you will get a security error when trying to access https://example.com

<supportagent>

If there are issues with SSL for the subdomain, app.example.com, escalate the ticket to SaaS Ops.

</supportagent>

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).
• PWA domain changes are published on Monday, Wednesday, and Friday at 08:00 UTC. Depending on when you submit your changes it may take up to 48 hours to complete the process. 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
  
  

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