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.