diff --git a/ome_zarr/writer.py b/ome_zarr/writer.py
index 7ce813da..1c89bbfa 100644
--- a/ome_zarr/writer.py
+++ b/ome_zarr/writer.py
@@ -632,6 +632,7 @@ def write_image(
         For a list of recommended units, see [ngff specification](https://ngff.openmicroscopy.org/specifications/0.5/index.html#axes-metadata).
     `**metadata` : dict
         Additional metadata to store.
+        Use the `metadata` kwarg, e.g., `metadata={"omero": {"name": "My image"}}`.
 
     Returns
     -------