diff --git a/docs/components/modal.md b/docs/components/modal.md
index 183c279ef1..8fa0f52f84 100644
--- a/docs/components/modal.md
+++ b/docs/components/modal.md
@@ -4,6 +4,7 @@ KModal is a pop-up modal component with a background overlay.
:::tip NOTE
If your use-case matches one of the scenarios below, consider using [KPrompt](/components/prompt) instead:
+
* you need a simple pop-up dialog to ask user to confirm their action
* the user performed an action and you first require them to provide input text
* you don't need many customization options for a simple modal with action buttons
@@ -688,26 +689,24 @@ Focus-trap requires at least one tabbable element to be present in modal at all