maximhq · akshaydeo · Nov 5, 2025 · Oct 28, 2025
diff --git a/docs.json b/docs.json
@@ -75,6 +75,7 @@
                                             "offline-evals/via-ui/advanced/presets",
                                             "offline-evals/via-ui/advanced/scheduled-runs",
                                             "offline-evals/via-ui/advanced/customized-reports",
+                                            "offline-evals/via-ui/advanced/tag-reports",
                                             "offline-evals/via-ui/advanced/dataset-evaluation"
                                         ]
                                     }

diff --git a/...valuate/how-to/optimize-evaluation-processes/tag-reports/add-tags-to-report.png b/...valuate/how-to/optimize-evaluation-processes/tag-reports/add-tags-to-report.png
diff --git a/...uate/how-to/optimize-evaluation-processes/tag-reports/filter-reports-by-tag.png b/...uate/how-to/optimize-evaluation-processes/tag-reports/filter-reports-by-tag.png
diff --git a/offline-evals/via-ui/advanced/tag-reports.mdx b/offline-evals/via-ui/advanced/tag-reports.mdx
@@ -0,0 +1,21 @@
+---
+title: Tag test runs
+description: Tag your test runs to group and filter them effectively
+---
+
+<Steps>
+<Step>
+
+Tag any test run by clicking the **Add tags** button in the left sidebar of the run report view. Search and select one or more tags from the dropdown. If a tag doesn't exist, it'll be created automatically.
+
+![Add tags](/images/docs/evaluate/how-to/optimize-evaluation-processes/tag-reports/add-tags-to-report.png)
+
+</Step>
+<Step>
+
+Once tagged, filter runs by tag from the runs table. Navigate to the runs page using the **Runs** button in the left sidebar of the Evaluate section.
+
+![Filter runs](/images/docs/evaluate/how-to/optimize-evaluation-processes/tag-reports/filter-reports-by-tag.png)
+
+</Step>
+</Steps>