diff --git a/cloud/architecture.mdx b/cloud/architecture.mdx
index 0501100f..0632c297 100644
--- a/cloud/architecture.mdx
+++ b/cloud/architecture.mdx
@@ -41,6 +41,12 @@ These environments act as the data plane to serve feature flag data to your appl
Each Flipt environment gets its own unique URL that you use to serve feature flag data to your applications. Our SDKs and API clients use this URL to connect to the Flipt instance in the Flipt Cloud environment.
+
+ You can now use your own custom domains with Flipt Cloud to serve feature flag
+ data to your applications. See the [Custom
+ Domains](/cloud/features/custom-domains) overview for more information.
+
+
## Evaluation
Flipt Cloud supports evaluation for our [client-side SDKs](/integration/client) out of the box. These SDKs are available for many popular programming languages, including JavaScript, TypeScript, Go, Java, Ruby, Python, and more. These client-side SDKs are designed with performance in mind, and store feature flag data in memory to serve feature flag evaluations quickly.
diff --git a/cloud/features/custom-domains.mdx b/cloud/features/custom-domains.mdx
new file mode 100644
index 00000000..f1cf87f7
--- /dev/null
+++ b/cloud/features/custom-domains.mdx
@@ -0,0 +1,100 @@
+---
+title: Custom Domains
+description: Learn how to use your own custom domains with Flipt Cloud
+mode: "wide"
+---
+
+
+ Custom domains are currently in beta. Contact us at
+ [support@flipt.io](mailto:support@flipt.io) to get access.
+
+
+## Overview
+
+Flipt Cloud allows you to use your own custom domains for evaluating feature flags against your Flipt Cloud instances. This means you can replace the default `*.flipt.cloud` domain with your own domain (like `features.acme.com`) when making API calls to Flipt.
+
+This is useful if you want to use a domain (or subdomain) that you already own in order to provide a branded experience for your users.
+
+
+
+
+
+ Custom domains are only available on our Team plan and above and incur a small
+ additional cost per month.
+
+
+## Why Use Custom Domains?
+
+There are a couple of reasons why you might want to use a custom domain with Flipt Cloud.
+
+### Professional Branding & White Labeling
+
+By default when using Flipt Cloud, every environment gets its own subdomain at `{your-environment}-{your-organization}.flipt.cloud`. When configuring our SDKs to evaluate feature flags, this is the domain that you'll use.
+
+For example, if you have an environment called `dev` and an organization called `acme-corp`, the default domain for that environment will be `dev-acme-corp.flipt.cloud`.
+
+Normally this is no big deal, but if you're using Flipt Cloud to power a product that you're selling to your customers, you may want to use your own domain to provide a branded experience. Particularly if you're using Flipt Cloud to power a mobile or browser based product, it's relatively easy for your users to inspect the network requests and see `flipt.cloud` in the request.
+
+By using your own domain, you can provide a more branded experience for your users, making the integration feel more seamless and professional.
+
+Instead of:
+
+```
+https://dev-acme-corp.flipt.cloud
+```
+
+You can use your own domain or subdomain:
+
+```
+https://features.acme.com
+```
+
+### Enhanced Security & Compliance
+
+Using custom domains can provide several security benefits:
+
+1. **Domain Allowlisting**: Many organizations maintain strict allowlists of approved domains for outbound network requests. Using your own domain makes it easier to comply with these security policies without having to allowlist `*.flipt.cloud`.
+
+2. **Network Isolation**: Some organizations use internal DNS to route traffic through security appliances or VPNs. Custom domains allow you to configure your DNS to route Flipt traffic through your existing security infrastructure.
+
+3. **Data Privacy**: Using your own domain helps mask the use of third-party services from end users, making it harder for potential attackers to identify which services your application depends on.
+
+## Setting Up Custom Domains
+
+
+ We're working on a guide to walk you through the process of setting up a
+ custom domain. Check back soon for more details!
+
+
+Using custom domains with Flipt Cloud is a simple three step process:
+
+1. **Configure the Domain**: Once enabled, you can add your custom domain to your Flipt Cloud environment in the Flipt Cloud UI.
+
+
+
+2. **Configure the DNS**: You'll need to configure the DNS for your custom domain to point to your existing Flipt Cloud environment.
+
+
+
+3. **Update Your SDKs**: Once the DNS has propagated, you simply need to update your SDKs to use the new domain.
+
+```typescript {2}
+const fliptEvaluationClient = await FliptEvaluationClient.init("default", {
+ url: "https://features.acme.com",
+ authentication: {
+ clientToken,
+ },
+});
+```
+
+## Limitations
+
+- Custom domains are a paid feature available on Team plans and above
+- Custom domains can only be used with Flipt Cloud SDKs for API calls
+- The Flipt Cloud UI will continue to use the `*.flipt.cloud` domain
diff --git a/cloud/features/user-management.mdx b/cloud/features/user-management.mdx
index 8c5c57a0..bbc0cc16 100644
--- a/cloud/features/user-management.mdx
+++ b/cloud/features/user-management.mdx
@@ -8,7 +8,7 @@ Flipt Cloud makes it easy to manage your team members and their permissions. You
-With features like [role-based access control](/cloud/features/rbac), you can ensure that team members have the right level of access to the features they need, while keeping sensitive data secure.
+With features like [Role-Based Access Control](/cloud/features/rbac), you can ensure that team members have the right level of access to the features they need, while keeping sensitive data secure.
diff --git a/images/cloud/features/domains/client-evaluation-cloud-dark.svg b/images/cloud/features/domains/client-evaluation-cloud-dark.svg
new file mode 100644
index 00000000..9f489b29
--- /dev/null
+++ b/images/cloud/features/domains/client-evaluation-cloud-dark.svg
@@ -0,0 +1,184 @@
+
diff --git a/images/cloud/features/domains/client-evaluation-cloud-light.svg b/images/cloud/features/domains/client-evaluation-cloud-light.svg
new file mode 100644
index 00000000..6c65c7c7
--- /dev/null
+++ b/images/cloud/features/domains/client-evaluation-cloud-light.svg
@@ -0,0 +1,112 @@
+
diff --git a/images/cloud/features/domains/client-evaluation-cloud.d2 b/images/cloud/features/domains/client-evaluation-cloud.d2
new file mode 100644
index 00000000..a39d7a0a
--- /dev/null
+++ b/images/cloud/features/domains/client-evaluation-cloud.d2
@@ -0,0 +1,52 @@
+vars: {
+ d2-config: {
+ layout-engine: elk
+ }
+}
+
+style: {
+ fill: transparent
+}
+
+direction: right
+
+app: "Your User's Browser" {
+ style: {
+ fill: transparent
+ }
+
+ javascript: "" {
+ shape: image
+ icon: https://icons.terrastruct.com/dev%2Fjavascript.svg
+ style.font-size: 32
+ }
+}
+
+
+cloud: "" {
+ style: {
+ fill: transparent
+ }
+
+ cloudInstance: Flipt Cloud {
+ shape: image
+ icon: https://flipt.cloud/icon.svg?3c7bba14eb804cba
+ style.font-size: 32
+ }
+
+ environments: Environments {
+ style: {
+ fill: transparent
+ stroke: "#000000"
+ stroke-dash: 3
+ }
+
+ fone: "" {
+ icon: https://assets-global.website-files.com/659480aa07716c37f0fd8dee/6597f2baa456ff33c9f13a07_logo%201.svg
+ }
+ }
+}
+
+app.javascript <-> cloud.environments.fone: features.acme.com {
+ style.font-size: 24
+}
\ No newline at end of file
diff --git a/images/cloud/features/domains/dns-configuration.png b/images/cloud/features/domains/dns-configuration.png
new file mode 100644
index 00000000..67603a4f
Binary files /dev/null and b/images/cloud/features/domains/dns-configuration.png differ
diff --git a/images/cloud/features/domains/environment-domain.png b/images/cloud/features/domains/environment-domain.png
new file mode 100644
index 00000000..ecf7f282
Binary files /dev/null and b/images/cloud/features/domains/environment-domain.png differ
diff --git a/mint.json b/mint.json
index ecaf75a8..dd3188a5 100644
--- a/mint.json
+++ b/mint.json
@@ -262,7 +262,8 @@
"cloud/features/approval-workflows",
"cloud/features/rbac",
"cloud/features/user-management",
- "cloud/features/verified-commits"
+ "cloud/features/verified-commits",
+ "cloud/features/custom-domains"
]
},
{
diff --git a/reo.js b/reo.js
index 856e8708..e1ed7a29 100644
--- a/reo.js
+++ b/reo.js
@@ -1 +1,12 @@
-!function(){var e,t,n;e="a9505926280f383",t=function(){Reo.init({clientID:"a9505926280f383"})},(n=document.createElement("script")).src="https://static.reo.dev/"+e+"/reo.js",n.defer=!0,n.onload=t,document.head.appendChild(n)}();
\ No newline at end of file
+!(function () {
+ var e, t, n;
+ (e = "a9505926280f383"),
+ (t = function () {
+ Reo.init({ clientID: "a9505926280f383" });
+ }),
+ ((n = document.createElement("script")).src =
+ "https://static.reo.dev/" + e + "/reo.js"),
+ (n.defer = !0),
+ (n.onload = t),
+ document.head.appendChild(n);
+})();
+
+
+