diff --git a/doc/release/upcoming_changes/21485.new_feature.rst b/doc/release/upcoming_changes/21485.new_feature.rst
new file mode 100644
index 000000000000..99fd5e92da17
--- /dev/null
+++ b/doc/release/upcoming_changes/21485.new_feature.rst
@@ -0,0 +1,5 @@
+``keepdims`` parameter for ``average``
+--------------------------------------
+The parameter ``keepdims`` was added to the functions `numpy.average`
+and `numpy.ma.average`.  The parameter has the same meaning as it
+does in reduction functions such as `numpy.sum` or `numpy.mean`.