From 02651fbf4acb682d150499ec4432b4c4ba3afd34 Mon Sep 17 00:00:00 2001
From: Isabel Matwawana <76437239+imatwawana@users.noreply.github.com>
Date: Fri, 22 Aug 2025 10:59:22 -0400
Subject: [PATCH] [release-12.1.2] Docs: Folder name character limitations
 (#110046)

---
 docs/sources/dashboards/manage-dashboards/index.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/docs/sources/dashboards/manage-dashboards/index.md b/docs/sources/dashboards/manage-dashboards/index.md
index 67ec9e71044..a2dc6e1e3ae 100644
--- a/docs/sources/dashboards/manage-dashboards/index.md
+++ b/docs/sources/dashboards/manage-dashboards/index.md
@@ -80,16 +80,18 @@ Folders help you organize and group dashboards, which is useful when you have ma
    - On the **Dashboards** page, click **New** and select **New folder** in the drop-down.
    - Click an existing folder and on the folder’s page, click **New** and select **New folder** in the drop-down.
 
-1. Enter a unique name and click **Create**.
+1. Enter a unique name.
+
+   Folder names can't include underscores (\_) or percentage signs (%), as it interferes with the search functionality.
+
+   Also, alerts can't be placed in folders with slashes (\ /) in the name. If you want to place alerts in the folder, don't use slashes in the folder name.
+
+1. Click **Create**
 
 When you nest folders, you can do so up to four levels deep.
 
 When you save a dashboard, you can optionally select a folder to save the dashboard in.
 
-{{< admonition type="note" >}}
-Alerts can't be placed in folders with slashes (\ /) in the name. If you wish to place alerts in the folder, don't use slashes in the folder name.
-{{< /admonition >}}
-
 **To edit the name of a folder:**
 
 1. Click **Dashboards** in the primary menu.