3. Custom domain

Guide to setting up a custom domain for the Loyalty Microsite, including DNS configuration steps, SSL verification, and requirements for embedding in your main website.

About custom domains in the Loyalty Microsite

By default, your Loyalty Microsite is served from:

• Production (Live): $micrositeSlug.web.wlloyalty.net

• Staging (Test): $micrositeSlug.staging.web.wlloyalty.net

For a seamless, white-label experience, you can configure the microsite to be accessible through a custom domain, such as rewards.acme.com if your main domain is acme.com.

Using a custom domain is required when embedding the microsite in your main website, as it must be served from a subdomain of the parent domain.

For more details on embedding the microsite, see 1. Deployment type.

---

Setting up a custom domain

To set up a custom domain for your Loyalty Microsite, follow these steps:

1

Choose a custom domain

Nominate a URL where you'd like the microsite to be accessible, e.g. rewards-microsite.acme.com. Consider your staging microsite domain too, if applicable.

2

Raise a support ticket

Raise a support ticket with WLL Support using the template below, filling in the blanks:

To: [email protected]
Subject: Custom domain setup for TENANTSLUG
_________________________________________
Please begin the custom domain setup for our microsite and provide back:
- the CNAME domain records which need adding
- the SSL verification records which need adding

**Tenant details (found in Loyalty Console > Settings > Tenant)
WLL Tenant Data Centre: EU/US (delete as applicable)
WLL Tenant Name: 
WLL Tenant Slug: 

**Microsite details (found in Loyalty Console > Interfaces > Microsites)
Production Microsite Slug: 
Production Microsite Custom Domain: 
Staging Microsite Slug: 
Staging Microsite Custom Domain: 

I am aware that these records will need adding to our domain configuration within 48 hours of WLL supplying them back to us.

3

SSL certificate request and microsite configuration

The WLL Support team will initiate the SSL certificate request and configure the microsite to allow access from your chosen custom domain.

4

Add DNS records

To complete the setup, add the DNS records supplied by WLL Support to your domain's DNS configuration. This consists of:

• Two SSL verification records (added as CNAME records). These are essential to secure your site and must be added within 48 hours of receiving them, or the verification will timeout.

• Two CNAME records to point to the microsite.

You can find instructions on how to add records to your DNS by searching the internet for 'Manage DNS records for X' where X is the name of your hosting provider i.e. GoDaddy or Hostinger.

5

Confirm with WLL Support

Once you’ve added all four records to your DNS settings, reply to WLL Support to confirm as further actions are required on our side once verification is complete.

6

Adding additional domains (optional)

If you wish to use multiple custom domains for the same microsite, set up redirects in your own domain configuration for all secondary domains to your primary custom domain. This ensures consistency and improves user experience.