diff --git a/docs/changelog.md b/docs/changelog.md
index 2f333b0a..2c90e24e 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -32,6 +32,7 @@ See the [Contributing Guide](contributing.md) for details.
 * Fix quadratic-time regex backtracking in `ReferenceProcessor` when a link
   reference definition has no URL, e.g. a line consisting only of `[id]:`
   followed by many trailing spaces (#798).
+* Document `attr_list` usage for `def_list` (#1123).
 
 ## [3.10.3] - 2026-07-30
 
diff --git a/docs/extensions/attr_list.md b/docs/extensions/attr_list.md
index 068c2f0f..82f2b5fd 100644
--- a/docs/extensions/attr_list.md
+++ b/docs/extensions/attr_list.md
@@ -111,6 +111,23 @@ A setext style header { #setext}
 ### A hash style header ### { #hash }
 ```
 
+Similarly, when using with the [Definition List] Extension, an attribute list
+must be on the same line as the term.
+
+``` md-render
+---
+extensions: [attr_list, def_list]
+---
+Apple { #apple }
+:   Pomaceous fruit of plants of the genus Malus in
+    the family Rosaceae.
+
+Orange { #orange }
+:   The fruit of an evergreen tree of the genus Citrus.
+```
+
+[Definition List]: ./definition_lists.md
+
 !!! seealso "See Also"
 
     By default, the [Fenced Code Blocks](./fenced_code_blocks.md#attributes) extension includes limited support for