Custom Domain

Having the Showell App for Web and your share links with your own domain/company name builds trust with your users and customers.

πŸ’‘Benefits of a custom domain:

  • Having the Showell App for Web and your share links with your own domain/company name builds trust with your users and customers.
  • When setting up the custom domain, you are also free to choose your subdomain. (see 'How does my custom domain looks like?' below)
  • Your Showell login page will now use your company colors and logo.
  • Your share links (towards the Digital Sales Room), will look identical to your custom domain, and will have /s/ added to its URL.
    ➑️
    For example: subdomain.companyname.com/s/....
  • Share links created before setting up your custom domain will still work.
  • Even with a custom domain set up, you are still able to login to Showell App for Web using showellapp.com, once you enter your username, you will be redirected to your new domain.

πŸ’‘Note:

  • Share links will only be created with the new custom domain using Showell 9.2.5 or higher. (How do I check my Showell App version?)
  • Setting up a custom domain with DNS configuration needs to be done by a person who has access to your domain configurations.
    ➑️ For example your company's IT department.


πŸ‘‰ This article will inform you on:



βž• Custom Domain is a Showell Add-on. If you'd like to know more:

How does my custom domain looks like?

There are 2 main options to form your custom domain:
  • Using your own company domain: subdomain.companyname.com
    ➑️ Requires DNS configuration
    ➑️ Ask your IT what subdomain is available
    • For Example: showell.companyname.com, sales.companyname.com, ...
  • Using the Showell domain: companyname.showell.app
    ➑️
    Does not require DNS configuration



How to set up your own custom domain name

  • Login to Showell Admin
  • On the top menu bar, click Your user name > Account settings
    Admin account settings
  • Scroll down and click Configure custom domains
    configure custom domains button
  • In the top right corner, click βž•New domain
  • Write the name of your custom domain and click Continue
    write custom domain name

    • subdomain.companyname.com ➑️ requires DNS configuration
      OR
    • companyname.showell.app ➑️ does NOT require DNS configuration
  • Your domain name will now have the status 'creating'.
    πŸ’‘
    Note that it might take a couple of minutes to go to the next status
    domain creating status
  • Once the domain name is created, it will have the status 'pending_verification'
    • πŸ‘‰ If you have chosen subdomain.companyname.com, You will first have to let your IT department configure the DNS.
    • Click 'Show DNS config'
      Show DNS config button
      domain DNS config
    • Configure your domain's DNS with the following records:
      1. CAA record to amazontrust.com (optional)*
      2. The DNS record for certificate verification (CNAME)
      3. The DNS record for routing (CNAME)
    • Once you have configured your domain's DNS, return to Showell Admin.
  • Note that the 'pending_verification'-status time can take up to 24 hours to process.
  • Once completed, your domain name will now have the status 'available'
  • Click 'Activate'
    Activate custom domain
    • you will see a pop-up window, click the link to see if it opens the Showell App for web login page (Note that you are not able to login yet).
    • click 'Activate'
  • Your domain name will now have the status 'active'
  • Congratulations, your custom domain is now ready! πŸŽ‰
    custom domain is now activated
    custom domain example

πŸ’‘*CAA record to amazontrust.com (optional):

Depending on your web hosting services, you might need to add a CAA record to amazontrust.com. Make sure to do so before adding the DNS record for certificate verification and routing.

  • Name: "companyname.com."
  • TTL: Equal to your other records (for example 3600)
  • Flags: "0"
  • Tag: "Issue" or "Issuewild"
    ➑️ If you already have an existing "issuewild" CAA record, then you must add it as an "issuewild" record.
    ➑️ If you only have "issue" CAA records, then you can add it as "issue" record.
  • Value: "amazontrust.com"

πŸ‘‰For more information: Configure a CAA record



πŸ’‘**Grant access:

You can grant access to other Showell accounts so that your custom domain can also be activated on those accounts.

  • When the Status is available or active, click 'Grant access'
    Grant access to other accounts with same custom domain

     

  • Toggle this option ON or OFF > click Close


πŸ’‘ Troubleshooting:

If you get the following error message, please follow the steps below to fix the issue:

failed: com.amazonaws.services.cloudfront.model.cnamealreadyexistsexception: one or more aliases specified for the distribution includes an incorrectly configured dns record that points to another cloudfront distribution. you must update the dns record to correct the problem. for more information, see https://docs.aws.amazon.com/amazoncloudfront/latest/developerguide/cnames.html#alternate-domain-names-restrictions (service: amazoncloudfront; status code: 409; error code: cnamealreadyexists; request id: 52ed275b-0c19-402a-9a5a-bf5a032a354f; proxy: null)

  • Remove the old records from your DNS
  • Remove the custom domain from Showell Admin
  • Wait for the old records to be removed from your DNS config cache
  • Create the custom domain in Showell Admin
  • Add the updated records from Showell to your DNS.
Showell