Custom Domains

Last modified: January 23, 2026

Introduction

Mendix Cloud supports adding custom domains, such as https://myapp.mycompany.com, to your application environments. This document describes how Technical Contacts can configure custom domains for applications on Mendix Cloud.

Prerequisites

General Prerequisites

Before starting this how-to, you need to have the following prerequisites:

Basic knowledge of DNS (Domain Name System)
A licensed node for which you have transport rights
A certificate must have been uploaded either at the application level by the Technical Contact or centrally by the Mendix Admin.

Custom domains can be added only to licensed apps. You cannot add custom domains to Free Apps.

Create and Configure a CNAME Record

Changes that affect DNS routing may not display immediately. This is because of DNS caching, where changes are not visible until the cache is updated.

Before configuring your custom domain in Mendix Cloud, you need to set up a DNS record for your custom domain with your domain registrar or DNS provider.

Create a CNAME (Canonical Name) record and point it to [YOUR-CUSTOM-DOMAIN].cname.mendix.net.. For example, if your custom domain is myapp.mycompany.com, create a CNAME record pointing to myapp.mycompany.com.cname.mendix.net. so that Mendix can direct your custom domain to your Mendix app.

It is not possible to create a CNAME record for an apex/naked domain (meaning, a domain without a subdomain, like mycompany.com). If you want to use a custom apex/naked domain, redirect it to a subdomain (for example, subdomain.mycompany.com) and create a CNAME for the subdomain instead.

Managing Custom Domains in Mendix Cloud

While custom domain certificates (or just "certificates") can be managed centrally or at the application level, custom domains are mainly managed per environment.

You can choose which certificate to use when you configure a custom domain for an environment (test, acceptance, or production).

To manage custom domains, follow these steps:

From Apps, go to the Environments page of your app.
Click Cloud Settings ( ) from any of the available tabs to open the Manage Cloud Settings page.
Switch to the Custom Domains tab.

Configuring a Custom Domain

Once a custom domain certificate has been uploaded, you can configure the custom domain for one of your application environments.

To configure a custom domain for your application environment, follow these steps:

Go to your app's Environments page.
Click Details ( ) on the environment you want to configure.
On the Environment Details page, go to the Network tab.
In the Custom Domains section, click Add to create a new custom domain (or Edit to edit an existing one).
Type the Domain name.
Select a Certificate from the drop-down list of uploaded certificates.
Click Save to save your custom domain. It will be configured for your application environment automatically.

Make sure you have configured a CNAME record for your custom domain with your domain registrar/DNS provider (for details, see Create and Configure a CNAME Record), above.

Frequently Asked Questions

How Do You Get my SAML Metadata or CommunityCommons.GetApplicationUrl to Use the Custom URL?

For certain use cases, it is important for the Mendix runtime to know the public URL of your applications. This is most commonly needed when your app generates links back to itself.

To tell the runtime where it lives, set the ApplicationRootUrl custom runtime setting. To set the custom runtime setting, follow the instructions in the Custom Runtime Settings section of Environment Details.

Can You Configure Multiple Custom Domains for the Same Application?

Yes, you can configure multiple custom domains for the same application.

For application-level certificates, you need to upload a separate certificate for each custom domain. You can only generate one certificate signing request (CSR) per custom domain.

For central certificates, a single certificate managed by the Mendix Admin can be reused across multiple custom domains and applications, if applicable.