From d08ec4c9abe0eef949b6712ae885c65f41facf87 Mon Sep 17 00:00:00 2001
From: Johannes <72809645+jobenjada@users.noreply.github.com>
Date: Wed, 23 Jul 2025 03:54:53 -0700
Subject: [PATCH] docs: Fix domain split docs (#6300)

Co-authored-by: Victor Hugo dos Santos <115753265+victorvhs017@users.noreply.github.com>
---
 .../configuration/domain-configuration.mdx          | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/self-hosting/configuration/domain-configuration.mdx b/docs/self-hosting/configuration/domain-configuration.mdx
index cd2478da34..4817be55fb 100644
--- a/docs/self-hosting/configuration/domain-configuration.mdx
+++ b/docs/self-hosting/configuration/domain-configuration.mdx
@@ -35,6 +35,10 @@ Formbricks supports a powerful domain separation feature that allows you to serv
 - Restrict admin functionality to the private domain
 - Ensure authentication and sensitive operations only occur on the private domain
 
+<Warning>
+Publicly available images uploaded before the domain split (logos, images in Picture Select questions, etc.) will continue to be served from the Private Domain. **To protect your Private Domain, please reupload public images after the successful setup of the domain split.**
+</Warning>
+
 ### Why Use Domain Split?
 
 - **Enhanced Security**: Separate public-facing surveys from your admin interface
@@ -145,4 +149,13 @@ If `PUBLIC_URL` is not set:
 - The system behaves as a single domain setup
 - No domain separation occurs
 
+### Reverting to a Single Domain
+While it's possible to revert to a Single Domain setup, please take into account the following:
+
+1. All image links and uploaded files are stored in the database, so they will continue to link to the Public Domain **hence the links will break.** You'll need to reupload the images, like you did when you set up the domain split. 
+2. Any survey link shared to with the Public Domain **will break.**
+3. API calls to the Public Domain **will break**, unless updated.
+
+As of now, Formbricks does not provide an automated migration between domain setups.
+
 If you have any questions or require help, feel free to reach out to us on [GitHub Discussions](https://github.com/formbricks/formbricks/discussions).