diff --git a/docs/user-guide/arrays.rst b/docs/user-guide/arrays.rst
index a62b2ea0fa..4952665e5c 100644
--- a/docs/user-guide/arrays.rst
+++ b/docs/user-guide/arrays.rst
@@ -30,6 +30,25 @@ module documentation.
 
 .. _user-guide-array:
 
+Initializing with data
+----------------------
+Pass existing data during array creation for convenience:
+
+.. code-block:: python
+
+   import zarr
+   import numpy as np
+
+   data = np.random.rand(1000, 1000)
+   arr = zarr.create_array("data.zarr", data=data)
+
+Equivalent to separate assignment:
+
+.. code-block:: python
+
+   arr = zarr.create_array("data.zarr", shape=(1000, 1000))
+   arr[:] = data
+
 Reading and writing data
 ------------------------