diff --git a/data/deprecations/16-8-remove-deprecated-metric-filter-from-dora-api.yml b/data/deprecations/16-8-remove-deprecated-metric-filter-from-dora-api.yml
new file mode 100644
index 0000000000000000000000000000000000000000..75a49e9b1752a4460ee745d8645a70f280a886cf
--- /dev/null
+++ b/data/deprecations/16-8-remove-deprecated-metric-filter-from-dora-api.yml
@@ -0,0 +1,9 @@
+- title: "`metric` filter and `value` field for DORA API"
+  announcement_milestone: "16.8"  # (required) The milestone when this feature was first announced as deprecated.
+  removal_milestone: "17.0"  # (required) The milestone when this feature is planned to be removed
+  breaking_change: true  # (required) If this deprecation is a breaking change, set this value to true
+  reporter: hsnir1  # (required) GitLab username of the person reporting the deprecation
+  stage: plan  # (required) String value of the stage that the feature was created in. e.g., Growth
+  issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/393172  # (required) Link to the deprecation issue in GitLab
+  body: |  # (required) Do not modify this line, instead modify the lines below.
+    Multiple DORA metrics can now be queried simultaneously using a new metrics field. The `metric` filter and `value` field for Graphql DORA API will be removed in GitLab 17.0.
diff --git a/doc/update/deprecations.md b/doc/update/deprecations.md
index cba85b1acd9f2248c11e37c7330da422d0295b04..e0c19a83439c702ef5004f124a0af74984b42bcc 100644
--- a/doc/update/deprecations.md
+++ b/doc/update/deprecations.md
@@ -1259,6 +1259,20 @@ removed in 17.0.
 
 <div class="deprecation breaking-change" data-milestone="17.0">
 
+### `metric` filter and `value` field for DORA API
+
+<div class="deprecation-notes">
+- Announced in GitLab <span class="milestone">16.8</span>
+- Removal in GitLab <span class="milestone">17.0</span> ([breaking change](https://docs.gitlab.com/ee/update/terminology.html#breaking-change))
+- To discuss this change or learn more, see the [deprecation issue](https://gitlab.com/gitlab-org/gitlab/-/issues/393172).
+</div>
+
+Multiple DORA metrics can now be queried simultaneously using a new metrics field. The `metric` filter and `value` field for Graphql DORA API will be removed in GitLab 17.0.
+
+</div>
+
+<div class="deprecation breaking-change" data-milestone="17.0">
+
 ### `postgres_exporter['per_table_stats']` configuration setting
 
 <div class="deprecation-notes">