diff --git a/docs/changelog.rst b/docs/changelog.rst
index 5c206624b..30ee4cac5 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -10,6 +10,13 @@ Beets now requires Python 3.9 or later since support for EOL Python 3.8 has
 been dropped.
 
 New features:
+* Ability to query albums with track db fields and vice-versa, for example
+  `beet list -a title:something` or `beet list artpath:cover`. Consequently
+  album queries involving `path` field have been sped up, like `beet list -a
+  path:/path/`.
+* Ability to query albums with track **flexible** fields and vice versa.
+* Queries have been made faster, and their speed is constant regardless of
+  their complexity or the type of queried fields.
 
 Bug fixes:
 
diff --git a/docs/reference/query.rst b/docs/reference/query.rst
index eaa2d6701..4abf80191 100644
--- a/docs/reference/query.rst
+++ b/docs/reference/query.rst
@@ -85,9 +85,11 @@ For multi-valued tags (such as ``artists`` or ``albumartists``), a regular
 expression search must be used to search for a single value within the
 multi-valued tag.
 
-Note that you can filter albums by querying tracks fields and vice versa::
+Note that you can filter albums by querying tracks fields, including
+flexible attributes::
 
     $ beet list -a title:love
+    $ beet list -a play_count::10
 
 and vice versa::