Skip to content
English
  • There are no suggestions because the search field is empty.

How to Create a Custom Advocate Portal Domain

Provide your advocates with a branded experience, follow this article to create a custom domain for your Advocate Portal.

Starting the Domain Process

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

  2. Go to Admin & Configuration > Domains > click the Custom Domains tab.

  3. Enter a domain that is unique for your Advocate Portal. For example, if your website is company.com, you could choose something like advocates.example.com. We recommend keeping it as short as possible.

  4. In Domain Usage, select Portal from the drop-down.

  5. In Certificate Type, select Automatic. 

  6. Select Create Domain.

Screenshot 2026-03-23 at 10.03.12 PM

 

Hostname Validation

After submitting, you'll have the option to Install Domain with your domain provider through the Custom Domain Integration with Goentri (see documentation here), or proceed below.  

Screenshot 2026-03-23 at 10.03.12 PM

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

Screenshot 2026-03-23 at 10.04.51 PM

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. 

  1. Select the domain, and either click Install domain to use the Custom Domain Integration for a quick configuration, or select View domain details to manually configure.

  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 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 - 12 hours), you will see the status of your custom domain change to Pending certificate validation. 

Screenshot 2026-03-23 at 10.09.04 PM

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.

    Screenshot 2026-03-23 at 10.10.28 PM

  2. Like in the section above, create a new TXT record. The Name will be the verification name 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, you can see the custom Portal Domain login URL at Pages & Widgets > Advocate Portal > Login. 

If you have any questions or need help, email support@getambassador.com