Customize link domain

  • Updated

Who is this article for?

This article will be useful to you if are a company looking to personalize the links provided to your partners.

Custom link domain overview

PartnerStack links are initially formatted as YourCompanyName.grsm.io or YourCompanyName.partnerlinks.io. Creating a custom link domain allows you to replace grsm.io/partnerlinks.io with a personalized alternative.

To create a custom domain you will need to have access to your DNS records, and the ability to create a CNAME record. Once you have created your CNAME record contact our support team to finalize your custom link creation. 

To create a custom link domain

1. Gain access to your DNS records

  • Speak with your engineers or webmaster to determine who has access to create a DNS record.
  • Decide on your link domain and subdomain
    • Your subdomain is the first part of the link. Many companies use the prefix "try" or "get", however, you may choose anything. For example, try.acme.com or get.acme.com
    • Your domain is simply the root domain of your website, for example, Acme.com 

2. Add DNS CNAME record

Create a CNAME record in your DNS to point your custom name to grsm.io or partnerlinks.io

yoursubdomain.yourdomain.com CNAME grsm.io

or

yourSubdomain.yourDomain.com CNAME partnerlinks.io

Should I use grsm.io or partnerlinks.io? 

To determine which CNAME you should point your domain to, log into your PartnerStack dashboard and navigate to your All Partners tab.

Select any partner and review the referral link format. If the links contain “grsm.io”, set up your CNAME record to point to grsm.io. If the links contain “partnerlinks.io”, set up your CNAME record to point to partnerlinks.io. 

For example, a company whose initial domain is grsm.io and decides to use the custom domain get.acme.com would set up the following record:

get.acme.com CNAME grsm.io

A company whose initial domain is partnerlinks.io and decides to use the custom domain get.acme.com would set up the following record:

get.acme.com CNAME partnerlinks.io

3. Contact PartnerStack Support

Please contact support@partnerstack.com and provide the details of the CNAME record you've established. 

4. Add TXT record to your DNS

The support team will provide you with a TXT record. Please confirm with the support team once you have added the TXT host and value to your DNS and they will finalize the custom domain creation.

5. Test Link

Basic Test

Once your custom link has been added to your account, test your link by appending /gstest to your custom link domain.

Using the example above, the Acme test link would be get.acme.com/gstest

Technical Test

You can also check the status of your custom links by using the 'dig' command in a console. This will return the DNS records for a given domain.

Open Terminal, and use dig as such:

$ dig customDomain.Domain.com  

Which should return,

ANSWER SECTION:

customDomain.Domain.com. 300 IN CNAME grsm.io.
grsm.io. 300 IN A 130.211.33.203

6. Notify your partners

Once you have replaced your existing grsm.io or partnerlinks.io links with a custom domain, please notify your partners. Partners can then update their links wherever they have shared them. 

While partners' original grsm.io or partnerlinks.io links will still work and track activity, users with Adblocker will see a "disable blocking and continue to the site" message. For more information on grsm.io links and Adblocker see our PartnerStack and Adblockers support guide.

Was this article helpful?

4 out of 4 found this helpful