diff --git a/docs/source/library-user-guide/upgrading/54.0.0.md b/docs/source/library-user-guide/upgrading/54.0.0.md
index 7911bbdc50fdb..0ba3e4eb3eaa1 100644
--- a/docs/source/library-user-guide/upgrading/54.0.0.md
+++ b/docs/source/library-user-guide/upgrading/54.0.0.md
@@ -557,6 +557,20 @@ are stored as `Arc<T>` so the map remains cheap to clone.
 - Custom `ParquetFileReaderFactory` implementations or other consumers that
   read `partitioned_file.extensions` and downcast manually.
 
+### `arrays_zip` struct field names changed
+
+The `arrays_zip` (and its alias `list_zip`) scalar function now names its
+output struct fields `"1"`, `"2"`, ..., `"n"` (1-indexed, matching DuckDB and
+Spark) instead of `c0`, `c1`, ..., `c{n-1}`.
+
+**Who is affected:**
+
+- Queries or downstream code that references the output struct fields by name
+  (e.g. `arrays_zip(a, b)[1]['c0']`). Update field accessors to `'1'`, `'2'`,
+  etc. (e.g. `arrays_zip(a, b)[1]['1']`).
+
+See [PR #20886](https://github.com/apache/datafusion/pull/20886) for details.
+
 ### `Box<C>` and `Arc<C>` `TreeNodeContainer` impls now require `C: Default`
 
 The generic `TreeNodeContainer` implementations for `Box<C>` and `Arc<C>` now