diff --git a/changelog/4709.doc.rst b/changelog/4709.doc.rst
new file mode 100644
index 000000000..5f21728f6
--- /dev/null
+++ b/changelog/4709.doc.rst
@@ -0,0 +1,2 @@
+Document how to customize test failure messages when using
+``pytest.warns``.