All Collections
Integrations & Tech Setup
Domains
Custom Share Link Domain Overview & Setup
Custom Share Link Domain Overview & Setup

How to create a custom share link domain to white label your referral links.

Ambassador Team avatar
Written by Ambassador Team
Updated this week

Overview

The custom share link domain acts as a vanity URL for your ambassador’s referral link. By default, the referral link is displayed like this: https://blue.mbsy.co/abc12. By creating a custom share link domain, it can instead appear as a more customized link like this: https://share.companyname.com/abc12.

Starting the Domain Process

Registering a domain for use with share links (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 Share Links.

  4. Enter a domain that is unique for your share links. For example, if your website is example.com, you could choose something like share.example.com or referral.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 “v1.ambassadorsharelinks.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.
    ​


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.


​Add URL to Campaign and test

Once the status is Completed, your final steps are to add the share link to your campaign(s) setup and test.

  1. Click into a Campaign, then scroll down on the Campaign Setup screen to the “Custom Short Domain” section. Type your full share link domain into the input box and save.
    ​


    ​

  2. Next, create a new enrolled contact and add them to a campaign to generate a share link. Open that share link in an incognito browser and make sure the share link redirects properly with no errors.

Adding the Same Domain to multiple Campaigns or Accounts

You can add the custom share link domain to multiple campaigns in a single account on your own, however if you need to use the same Share Link Domain on multiple company Accounts, you will need to have support assist you. Work with your existing technical support contact or email support@getambassador.com to request assistance.

If you have any questions or issues, reach out to existing technical support contact or support@getambassador.com.

Did this answer your question?