diff --git a/docs/en_US/images/query_tool_macros_clear_all.png b/docs/en_US/images/query_tool_macros_clear_all.png
new file mode 100644
index 0000000000000000000000000000000000000000..00b979e76e29a3e65cc31bb7beb1591a19b9fb28
GIT binary patch
diff --git a/docs/en_US/images/query_tool_macros_clear_row.png b/docs/en_US/images/query_tool_macros_clear_row.png
index 62ab6b047c025ed2b7c6d200648c2811c87a84c5..adf1ace916f076ad87bfa599a4102e754cc57253 100644
GIT binary patch
diff --git a/docs/en_US/images/query_tool_manage_macros.png b/docs/en_US/images/query_tool_manage_macros.png
new file mode 100644
index 0000000000000000000000000000000000000000..bc5bb1ab85eda149fd8cfe32c65af05e92bc36b7
GIT binary patch
diff --git a/docs/en_US/query_tool.rst b/docs/en_US/query_tool.rst
index 82e6a4a99..880ca4ffb 100644
--- a/docs/en_US/query_tool.rst
+++ b/docs/en_US/query_tool.rst
@@ -325,27 +325,37 @@ User can connect to another server or database from existing open session of que
 Macros
 ******
 
-Query Tool Macros enable you to execute pre-defined SQL queries with single key press. Pre-defined queries can contain the placeholder $SELECTION$. Upon macro execution, the placeholder will be replaced with the currently selected text in the Query Editor pane of the Query Tool.
+Query Tool Macros enable you to execute pre-defined SQL queries with a single key press. Pre-defined queries can contain the placeholder $SELECTION$. Upon macro execution, the placeholder will be replaced with the currently selected text in the Query Editor pane of the Query Tool.
 
-To create a macro, select the *Manage Macros* option from the *Macros* menu on the *Query Tool*. Select the key you wish to use, enter the name of the macro, and the query, optionally including the selection placeholder, and then click the Save button to store the macro.
+.. image:: images/query_tool_manage_macros.png
+   :alt: Query Tool Manage macros
+   :align: center
+
+To create a macro, select the *Manage Macros* option from the *Macros* menu on the *Query Tool*. Select the key you wish to use, enter the name of the macro, and the query, optionally including the selection placeholder, and then click the *Save* button to store the macro.
 
 .. image:: images/query_tool_manage_macros_dialog.png
    :alt: Query Tool Manage Macros dialogue
    :align: center
 
-To clear a macro, select the macro on the Manage Macros dialogue, and then click the Clear button.
+To clear a macro, select the macro on the *Manage Macros* dialogue, and then click the *Clear* button.
 
 .. image:: images/query_tool_macros_clear_row.png
    :alt: Query Tool Manage Macros clear the row
    :align: center
 
-It asks for the confirmation to clear a macro.
+The server will prompt you for confirmation to clear the macro.
 
 .. image:: images/query_tool_macros_clear_confirmation.png
    :alt: Query Tool Manage Macros Clear row confirmation
    :align: center
 
-To execute a macro, simply press the appropriate shortcut keys, or select it from the Macros menu.
+To clear all macros, click on the *Clear* button on left side of the key. The server will prompt you for confirmation to clear all the rows.
+
+.. image:: images/query_tool_macros_clear_all.png
+   :alt: Query Tool Macros Clear All
+   :align: center
+
+To execute a macro, simply select the appropriate shortcut keys, or select it from the *Macros* menu.
 
 .. image:: images/query_tool_macros_execution.png
    :alt: Query Tool Macros Execution
diff --git a/docs/en_US/query_tool_toolbar.rst b/docs/en_US/query_tool_toolbar.rst
index ba85603d6..2168c3930 100644
--- a/docs/en_US/query_tool_toolbar.rst
+++ b/docs/en_US/query_tool_toolbar.rst
@@ -185,5 +185,5 @@ Query Execution
    |                      | dialogue.                                                                                         |                |
    +----------------------+---------------------------------------------------------------------------------------------------+----------------+
    | *Macros*             | Click the *Macros* icon to manage the macros. You can create, edit or clear the macros through    |                |
-   |                      | *Manage Macros* option.                                                                           |                |
+   |                      | the *Manage Macros* option.                                                                       |                |
    +----------------------+---------------------------------------------------------------------------------------------------+----------------+
