How Do I Set up My White-Label Agency Dashboard?

For users to be able to access your white-label Agency dashboard, you must first provide Shoutem with at least 3 subdomains that we can use to point to your dashboard. Since there are many different domain providers, feel free to drop us an email using this form if you encounter any difficulties.

In order to set the redirection correctly on your domain, you want to find the DNS settings under your web domain account. DNS settings are separated into a few categories and we’ll be working with CNAME for setting this up.

First, you need to find your domain’s DNS area. This can be labeled as “DNS Settings”, “DNS Control”, “DNS Manager”, “Advanced Zone Control” or something similar. If you can’t find something like this, feel free to reach out.

Setting up redirection for your White-label dashboard

When you find the DNS settings, select the “Add New Record” or a similar option depending on your domain provider. For Agency account, you will need to add 3 records in total. In order to allow your clients to visit your white-label Agency dashboard, you will need to set-up CNAME domain name redirection with following parameters:

Step 1

  • Record type: CNAME
  • Name (subdomain) – builder.yoursite.com
  • Points to / Hostname / Alias / Destination / Record Value – Point your subdomain to: whitelabel.shoutem.com
  • TTL Value – Not all control panels have this. If you do, leave this value at its default. No need to change this.

Step 2

  • Record type: CNAME
  • Name (subdomain) – *.api.yoursite.com 
    My domain provider does not support wildcards, what should I do?
  • Points to / Hostname / Alias / Destination / Record Value – Point your subdomain to: whitelabel.api.shoutem.com
  • TTL Value – Not all control panels have this. If you do, leave this value at its default. No need to change this.

Step 3

  • Record type: CNAME
  • Name (subdomain) – v4.yoursite.com
  • Points to / Hostname / Alias / Destination / Record Value – Point your subdomain to: whitelabel.shoutem.com
  • TTL Value – Not all control panels have this. If you do, leave this value at its default. No need to change this.

Once the values are entered, confirm these settings by selecting “Save”, “OK” or “Submit” depending on your provider.

After you set this up, it can take up to 48h to give the DNS server of your domain provider enough time to refresh itself and process the change.

Adding your domain to Shoutem dashboard

Once you create CNAME records, you should link your domain with Shoutem builder as a final integration step. To do so, please log into your Shoutem builder, then tap on caret icon next to your e-mail address in upper right corner and choose My Account -> Agency. You will find the “Custom domains” field there and simply add your domain.