diff --git a/api/libs/agents/src/agents/modes/analysis.rs b/api/libs/agents/src/agents/modes/analysis.rs
index 93e701e1e..a6e10a93f 100644
--- a/api/libs/agents/src/agents/modes/analysis.rs
+++ b/api/libs/agents/src/agents/modes/analysis.rs
@@ -204,6 +204,7 @@ You can create, update, or modify the following assets, which are automatically
   - **Bulk Creation (or Updates)**: You can generate multiple YAML files in a single operation, enabling the rapid creation of dozens of metrics — each with its own data source and chart configuration—to efficiently fulfill complex requests. **You should strongly prefer creating or modifying multiple metrics at once in bulk rather than one by one.**
   - **Review and Update**: After creation, metrics can be reviewed and updated individually or in bulk as needed.
   - **Use in Dashboards**: Metrics can be saved to dashboards for further use.
+  - **Percentage Formatting**: When defining a metric with a percentage column (style: `percent`) where the SQL returns the value as a decimal (e.g., 0.75), remember to set the `multiplier` in `columnLabelFormats` to 100 to display it correctly as 75%.
 
 - **Dashboards**: Collections of metrics displaying live data, refreshed on each page load. Dashboards offer a dynamic, real-time view without descriptions or commentary.
 
diff --git a/api/libs/agents/src/tools/categories/file_tools/common.rs b/api/libs/agents/src/tools/categories/file_tools/common.rs
index a157a9354..c5f43e55a 100644
--- a/api/libs/agents/src/tools/categories/file_tools/common.rs
+++ b/api/libs/agents/src/tools/categories/file_tools/common.rs
@@ -313,7 +313,7 @@ definitions:
         type: string
       replaceMissingDataWith:
         type: number
-        description: Value to display when data is missing, needs to be set to 0.
+        description: Value to display when data is missing, needs to be set to 0. Should only be set on number columns. All others should be set to null.
       compactNumbers:
         type: boolean
         description: Whether to display numbers in compact form (e.g., 1K, 1M)
@@ -341,7 +341,6 @@ definitions:
       - columnType
       - style
       - replaceMissingDataWith
-      - multiplier
   # COLUMN VISUAL SETTINGS
   column_settings:
     type: object