---
description: >-
  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.
---

# 3. Custom domain

## 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.&#x20;

{% hint style="info" %}
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](1.-deployment-type "mention").
{% endhint %}

***

## Setting up a custom domain

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

{% stepper %}
{% step %}
### 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.
{% endstep %}

{% step %}
### Raise a support ticket

Raise a support ticket with [wll-support](../../../../services-and-support/wll-support "mention") using the template below, filling in the blanks:

{% code overflow="wrap" %}
```
To: support@whitelabel-loyalty.com
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.
```
{% endcode %}
{% endstep %}

{% step %}
### 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.
{% endstep %}

{% step %}
### Add DNS records

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

* [x] Two **SSL verification records** (added as CNAME records). These are essential to secure your site and <mark style="color:red;">**must be added within 48 hours of receiving them**</mark>, or the verification will timeout.
* [x] 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.
{% endstep %}

{% step %}
### 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.
{% endstep %}

{% step %}
### 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.
{% endstep %}
{% endstepper %}
