Docs are being personalised for new programs
SaaSquatch Help Center

Setting Up a Custom Subdomain for a SaaSquatch Microsite

Set a custom subdomain for your SaaSquatch Microsite to align with your brand.

IMPORTANT: There's a more recent doc available on this topic. Please go to: Setting Up a Domain.

🔗 About SaaSquatch microsites

SaaSquatch microsites allow your affiliates or customers to sign up and have access to the referral widget. This is ideal when participants referred to your program would not have access to an account on your website (this is common for affiliates, as an example). Check out our Microsites Overview doc for a high-level overview of the microsite setup process or jump straight into our detailed setup guide.

🔗 Before you begin

This guide is for companies using SaaSquatch microsites. To set up your custom domain, you will need the ability to either:

  • (Recommended) Change your DNS (Domain Name Server) settings
  • Configure a reverse proxy to send traffic to the microsite, if you can’t change the DNS settings

🔗 Connect a Custom Subdomain to your SaaSquatch Microsite

You can set a custom domain to more closely align with your brand. For instance, you could have portal.YourCompany.com.

Important: You’ll need access to your DNS (Domain Name Server) settings to do this.

  1. Head to your domain register.
  2. Add a new DNS record in the DNS settings for your chosen domain.
    • Record type: CNAME
    • Host (Name): (enter your preferred subdomain here)
    • Value: ssqt.co
    • TTL: Automatic or 1 Hour
  3. Notify the Success team that you have configured the CNAME record for your SaaSquatch microsite.

Next, your Solutions Architect will finish connecting the custom domain to your microsite.

🔗 Configure a reverse proxy for your SaaSquatch Microsite

In advanced cases, you can host a reverse proxy to ssqt.co. We only recommend this if:

  • You can’t modify your DNS to add the CNAME record to ssqt.co
  • You want to manage your own TLS certificate

This option requires extra setup and infrastructure to be hosted by your technical team.

Configure the reverse proxy to:

  1. Reverse proxy all requests to your custom domain to go to ssqt.co.
  2. Send the Host header with your custom domain along with all requests, for example Host: referrals.example.com.

As SaaSquatch will not have a signed certificate for your custom domain, your reverse proxy will have to accept the default certificate for ssqt.co when proxying requests.