From 79fea8fa6d661cb64a421d33c58a804c9c07b659 Mon Sep 17 00:00:00 2001
From: Xuanwo <github@xuanwo.io>
Date: Fri, 27 Feb 2026 12:26:55 +0800
Subject: [PATCH] Codex worktree snapshot: new-branch-cleanup

Co-authored-by: Codex
---
 docs/src/guide/data_types.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/src/guide/data_types.md b/docs/src/guide/data_types.md
index c7853695f36..4189fdc2815 100644
--- a/docs/src/guide/data_types.md
+++ b/docs/src/guide/data_types.md
@@ -283,6 +283,7 @@ ds = lance.write_dataset(table, "./with_metadata.lance")
 ### Map Types
 
 Store key-value pairs with dynamic keys:
+Map writes require Lance file format version 2.2 or later.
 
 ```python
 import lance
@@ -301,7 +302,7 @@ table = pa.Table.from_pydict({
     ],
 }, schema=schema)
 
-ds = lance.write_dataset(table, "./with_maps.lance")
+ds = lance.write_dataset(table, "./with_maps.lance", data_storage_version="2.2")
 ```
 
 ## Data Type Mapping for Integrations