diff --git a/content/en/docs/marketplace/platform-supported-content/modules/data-widgets/data-grid-2.md b/content/en/docs/marketplace/platform-supported-content/modules/data-widgets/data-grid-2.md
index 9e657fe91af..cf40303c22a 100644
--- a/content/en/docs/marketplace/platform-supported-content/modules/data-widgets/data-grid-2.md
+++ b/content/en/docs/marketplace/platform-supported-content/modules/data-widgets/data-grid-2.md
@@ -247,6 +247,9 @@ The new data grid can trigger some events while iterating with it.
 
 Triggers an action (such as a nanoflow, microflow, or Show page action) when the end-user clicks in one of the rows. It also adds a pointer cursor to signal that it is clickable. This function also complies with accessibility features and can be reached using only the keyboard.
 
+### On Selection Change Action
+Triggers an action (such as a nanoflow, microflow, or client action) when the end-user changes the selection in the data grid. This includes selecting or deselecting individual rows, using the select all toggle, or clearing the selection. The action provides a way to respond to selection state changes and implement custom logic based on the current selection.
+
 ## Filters {#filters}
 
 Data Grid 2 uses a modular filtering system with dedicated filter widgets that can be placed in two locations:
@@ -587,6 +590,34 @@ The setting for action triggers is related to the selection method and can somet
 
 To achieve this behavior, set the **On click trigger** to **Double click**. When a data grid is configured this way, the user may select a row by double-clicking it.
 
+### Selection and Header Actions
+
+Selected rows can be passed to actions triggered by buttons in the grid header.
+
+#### Header Action buttons
+Header action buttons are placed in the **Header** above the grid. These buttons are used to perform actions on selected rows.
+
+#### How Selection is passed to Actions
+When a header action button triggers a **microflow** or **nanoflow**, the selected rows are passed as input:
+
+- If **Single Selection** is enabled:
+  - The action receives a **single object**.
+- If **Multiple Selection** is enabled:
+  - The action receives a **list of objects**.
+
+This allows developers to build logic that operates on one or many items.
+
+#### Example use cases
+- **Mark as Done**: A button triggers a microflow that updates the status of selected tasks.
+- **Delete Selected**: A button deletes all selected records.
+- **Export Selected**: A button exports selected rows to a file.
+
+#### Configuration
+1. Enable selection in the Data Grid 2 widget.
+2. Insert an Action Button into the Header.
+3. Configure the button to trigger a microflow or nanoflow.
+4. Set the input parameter of the flow to match the selection type (single object or list).
+
 ## Keyboard Support {#keyboard-support}
 
 | Key                                                                  | Function                                                                                            |