# Add Custom Domain

The Limio Shop and Self-Service pages are generated by the Limio Commerce app and **can be hosted on your custom domain.** By default, these pages are initially hosted on a Limio domain, such as `{tenant}-shop.prod.limio.com`. However, they are designed to be hosted on your company’s specific domain for a seamless user experience.

To host these pages on your custom domain, please follow these steps:

## How to setup an extra domain in Limio?

1. To set up a new domain, please contact Limio Support at <support@limio.com> with the following details:
   * The desired domain name (e.g., `subscribe.mydomain.com`).
   * The environment it applies to (e.g., `{tenant}-shop.prod.limio.com`).
2. Once the Limio team completes the domain configuration, we will provide you with the required technical specifications to set up the **CNAME aliases** for hosting the Limio site on your custom domain. These details will include:

   1. **CNAME for routing**: Directs traffic to your Limio-hosted site.
   2. **CNAME for SSL validation**: Ensures secure access via an SSL certificate.

   It is essential for your technical team to review and approve these specifications, then add the necessary records to your domain registrar. **Please note that this process must be done within 48 hours or the CNAME records will expire.**

| **Record Name**                                                                                                                                                                     | **Record Type** | **Record Value**                                                    | **Description**                                                                                                                |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| [`subscribe.mydomain.com`](http://subscribe.irmi.com/)                                                                                                                              | CNAME           | `{tenant}-shop.prod.limio.com`                                      | Routes connection to limio                                                                                                     |
| <p><a href="http://subscribe.irmi.com/"><code>\_5dcb619ca32ebe6c15d539372218d08a.</code></a></p><p><a href="http://subscribe.irmi.com/"><code>subscribe.mydomain.com</code></a></p> | CNAME           | \_93778965dsfjhssb4d17f523de203e12 .zxwlrjxpwn.acm-validations.aws. | [Authorises generation of SSL certificate for ](http://taskility.com/)[subscribe.your-website.com](http://subscribe.irmi.com/) |

Please ensure these configurations are applied accurately to avoid any disruptions. Once your technical team approves the configurations, the Limio team will finalise the setup process. Provisioning a domain name can take 48h to create and propagate.

After completion, your **Limio Shop** and **Self-Service** pages will be accessible on your custom domain. Additionally, the custom domain will be visible within the **Limio Commerce** application.

***

## Impact on Zuora Hosted Payment Methods (HPM)

If you use **Zuora HPM** (Hosted Payment Methods) for payment collection, switching to a custom domain requires an update to your Zuora HPM configuration.

Zuora HPM iframes validate the **host domain** of the parent page. After moving to a custom domain, the HPM iframe will reject requests from the new domain unless it is explicitly allowed.

{% hint style="warning" %}
**After configuring your custom domain**, update the allowed domain in your Zuora HPM page settings to match your new domain (e.g. `subscribe.mydomain.com`). If this is not updated, payment forms will fail to load or submit on the custom domain. Contact <support@limio.com> if you need assistance updating the HPM configuration.
{% endhint %}