Skip to main content
All CollectionsIntegrations & Tech SetupDomains
How to setup a custom Portal Domain
How to setup a custom Portal Domain
Ambassador Team avatar
Written by Ambassador Team
Updated over 7 months ago

Overview

By default, the Ambassador Portal is set to live at yourcompanyname.getambassador.com. Creating a custom domain for your Ambassador Portal is a great way to keep your branding consistent and provide a white labeled experience for your ambassadors.

 

How do I create a custom domain for my portal?

Registering a domain for use with the Portal (or any other feature supporting custom domains) is straightforward.

  1. Navigate to admin.getambassador.com and log in.

  2. Go to the Domains tab.

  3. In the Custom Domains form, choose Portal for Usage Type.

  4. Enter a domain that is unique for your Ambassador Portal. For example, if your website is http://example.com , you could choose something like portal.example.com or ambassadors.example.com.

  5. Choose Add Domain to start the provisioning process.

Note: In the near future, custom domains will support custom certificates. For now, all TLS certificates are issued automatically by Cloudflare.

When you return to the Custom Domains page, you will see your new domain listed next to the Status Pending hostname validation. This means that the domain is ready for configuration.

Hostname Validation

In this section, you will verify your ownership of the custom domain you configured in the first section, allowing Ambassador to serve the link through it. These next steps may vary slightly depending on your hostname registrar. In this example, we will use Cloudflare DNS, but these steps will work with any provider.

  1. Click the checkbox next to the custom domain you configured in the first section and click View Domain.

  2. A Domain Details dialog will appear with information used to validate your domain.
    ​

  3. Create a CNAME record with your chosen subdomain with a target of “http://v1.ambassadorportalv2.com ”:
    ​

  4. Create a TXT record for _cf-custom-hostname.<yourdomainhere> as indicated in Domain Details. The Content for the TXT record will be the Hostname verification value.
    ​

  5. After some time (typically 5 min - 4 hours), you will see the status of your custom domain change to Pending certificate validation.
    ​

    Once you receive this status message, you are ready for final steps.

Certificate Validation

Finally, to ensure your customers have the best experience, our custom domain name provider will issue a certificate against your custom host name. This will show that your snippet is being served securely on your website.

  1. Find the Certificate verification name and Certificate verification value on the Domain Details dialogue.
    ​

  2. Like in the section above, create a new TXT record. The Name will be the verification name and the Content will be the verification value.
    ​

  3. After the TLS certificate has been requested, the Status will change to Certificate requested.

  4. Once the certificate is provisioned, the status will change to Completed.
    ​

Note: The time needed to validate the domain and certificate can range anywhere from 15 minutes to several hours. The automated checks happen less frequently over time.

Once the status is Completed, alert our team to enable this new custom portal domain in your account from our backend configuration.

Did this answer your question?