cellOnClick change

Author: andrewkenreich

content/workspace/developers/json-specs/widgets-json-reference.md

@@ -320,6 +320,11 @@ A `Widgets.json` table is a configuration structure with any of the named attrib
             _Example:_ `"id"`
             _Example use case:_ If your table displays company names in the cell but your API expects company IDs, set `valueField: "companyId"` to use the ID field from the row data instead of the displayed name.
 
+          - **forceUpdate**
+            _Type:_ `boolean` (optional)
+            By default, clicking a cell updates the shared parameter for the other widgets in the group, but the widget containing the clicked cell does not re-fetch its own data. Set this to `true` to force the source widget to update as well when one of its cells is clicked.
+            _Example:_ `true`
+
         - **colorValueKey**
           _Type:_ `string`
           Specifies which field to use for determining the color when showing cell changes.

content/workspace/developers/widget-configuration/render-functions.md

@@ -235,6 +235,32 @@ In this example:
 ]
 ```
 
+### Using forceUpdate to Refresh the Source Widget
+
+By default, when a cell click updates a parameter through the `groupBy` action, only the other widgets that share the parameter are refreshed — the widget containing the clicked cell does not re-fetch its own data. If the source widget also uses the parameter (for example, the table filters or highlights rows based on the selected symbol), set `forceUpdate: true` so it updates too:
+
+```json
+{
+    ...
+    "columnsDefs": [
+        {
+            "field": "symbol",
+            "headerName": "Symbol",
+            "renderFn": "cellOnClick",
+            "renderFnParams": {
+                "actionType": "groupBy",
+                "groupBy": {
+                    "paramName": "symbol",
+                    "forceUpdate": true
+                }
+            }
+        }
+    ]
+}
+```
+
+With `forceUpdate: true`, clicking a symbol cell updates the `symbol` parameter and re-fetches the table widget's own data in addition to updating the other widgets in the group.
+
 ### Hover Card
 
 To use the hover card render function, you need to add it to the `columnsDefs` array in your `widgets.json` file for the column you want to apply it to.

content/workspace/developers/widget-parameters/cell-click-grouping.md

@@ -229,3 +229,31 @@ In this example:
 - When displaying human-readable text but needing to pass IDs or codes
 - When the displayed value differs from the parameter value format
 - When you want to decouple the display value from the API parameter value
+
+## Using forceUpdate to Refresh the Source Widget
+
+By default, clicking a cell only updates the other widgets that share the parameter — the table widget containing the clicked cell does not re-fetch its own data. This avoids unnecessary requests, since the table usually just provides the selection.
+
+If the table widget itself also depends on the parameter (for example, it filters or highlights its rows based on the selected symbol), set `forceUpdate: True` in the `groupBy` configuration so the source widget re-fetches its data as well:
+
+```python
+{
+    "field": "symbol",
+    "headerName": "Symbol",
+    "cellDataType": "text",
+    "width": 120,
+    "renderFn": "cellOnClick",
+    "renderFnParams": {
+        "actionType": "groupBy",
+        "groupBy": {
+            "paramName": "symbol",
+            "forceUpdate": True  # Also re-fetch this widget's data on click
+        }
+    }
+}
+```
+
+**When to use forceUpdate:**
+
+- When the table widget's own endpoint uses the parameter being updated
+- When clicking a cell should refresh the data shown in the source table, not just the connected widgets