# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.limio.com/product/settings/how-to-add-your-custom-domain-to-limio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.