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:
- For your custom subdomain to work properly you cannot use Forwarding features from your domain registrar to redirect your subdomain to our default white-labeled PWA URL. The only officially supported way is to use a CNAME redirect as indicated below.
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 towebapp.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 ownexample.com
, and configure your PWA to the subdomainapp.example.com
, you will be able to accesshttps://app.example.com
as we generated that certificate, but without a proper certificate forexample.com
, you will get a security error when trying to accesshttps://example.com
<supportagent>
If there are issues with SSL for the subdomain, app.example.com
, escalate the ticket to SaaS Ops.
</supportagent>
-
Go to Settings > Domain & SEO > Web App Domain. and click Add.
-
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.
Comments
0 comments
Please sign in to leave a comment.