diff --git a/content/codeberg-pages/using-custom-domain.md b/content/codeberg-pages/using-custom-domain.md
index fd87e10..caa8281 100644
--- a/content/codeberg-pages/using-custom-domain.md
+++ b/content/codeberg-pages/using-custom-domain.md
@@ -83,6 +83,20 @@ Depending on from where you want to serve your files, there is a naming scheme f
  </tbody>
 <table>
 
+{% admonition "warning" "Repository names with dots are not supported" %}
+
+Repository names containing dots (`.`) are **not supported** for custom domains. The Pages server uses dots as delimiters to parse the repository name, branch, and owner from DNS records.
+
+For example, if your repository is named `my.project`, the TXT record `my.project.username.codeberg.page` will be incorrectly parsed as:
+
+- Branch: `my`
+- Repository: `project`
+- Owner: `username`
+
+**Solution:** If you need to use a custom domain, rename your repository to use hyphens (`-`) or underscores (`_`) instead of dots. For example, rename `my.project` to `my-project`.
+
+{% endadmonition %}
+
 _We assume for the following description, that you want to serve your website with and without www in front.
 If you are on a subdomain already (like myproject.yourdomain.com), you can skip the `www.yourdomain.com` CNAME entry._