From e355d2f191236feb34f6234945c92d6e1b2d807c Mon Sep 17 00:00:00 2001
From: tudor <7089284+tudddorrr@users.noreply.github.com>
Date: Mon, 30 Mar 2026 23:01:13 +0100
Subject: [PATCH] channel storage prop array docs

---
 docs/godot/channels.mdx | 46 ++++++++++++++++++++++++++++++++++++++++-
 docs/unity/channels.mdx |  2 +-
 2 files changed, 46 insertions(+), 2 deletions(-)

diff --git a/docs/godot/channels.mdx b/docs/godot/channels.mdx
index a593c21..9907f24 100644
--- a/docs/godot/channels.mdx
+++ b/docs/godot/channels.mdx
@@ -5,7 +5,7 @@ description: Talo Channels add instant interactivity to your game. Channels can
 
 import { ScopeBadges } from '@site/src/components/ScopeBadges'
 
-# Channels
+# Channels and storage
 
 Talo Channels are a way of passing messages between players that are subscribed to a specific topic. Channels can be used for player chats, sending arbitrary JSON to various groups and pushing game updates directly to clients.
 
@@ -281,6 +281,34 @@ func _ready() -> void
 	)
 ```
 
+### Setting storage prop arrays
+
+<ScopeBadges scope='gameChannels' write />
+
+Prop arrays are a special type of prop that can store multiple values under the same key. This is useful for storing lists of items, player IDs or other data that can have multiple values.
+
+:::info
+Array keys are internally suffixed with [] (e.g. a key of "world_items" is stored as "world_items[]").
+
+When using the prop-array-specific functions, you should reference the key without the [] suffix.
+:::
+
+```gdscript
+# create an entity that will help us manage props
+var entity := TaloEntityWithProps.new()
+
+var key := "world_items"
+var items := ["sword", "shield", "potion"]
+
+for item in items:
+	entity.insert_into_prop_array(key, item)
+
+var prop_array := entity.find_props_by_key(key)
+await Talo.channels.set_storage_props(channel.id, TaloPropUtils.props_to_dictionary(prop_array))
+```
+
+You can handle failures in the same way as described above. Individual props have the same limitations as regular props and prop arrays have an additional limit of 1000 items.
+
 ### Getting storage props
 
 <ScopeBadges scope='gameChannels' read />
@@ -312,6 +340,22 @@ var prop := await Talo.channels.get_storage_prop(channel.id, "shared-gold", fals
 var freshProp := await Talo.channels.get_storage_prop(channel.id, "shared-gold", true)
 ```
 
+### Getting storage prop arrays
+
+Prop arrays are made up of multiple props with the same key. To fetch all items in a prop array, use `Talo.channels.get_storage_prop_array()`:
+
+<ScopeBadges scope='gameChannels' read />
+
+```gdscript
+var prop_key := "world_items"
+var array_items := await Talo.channels.get_storage_prop_array(channel.id, prop_key)
+
+for prop in array_items:
+	print(prop.value)
+```
+
+The same cache busting mechanism from above applies to `get_storage_prop_array()` as well. Simply provide `true` as the third parameter to skip the internal cache and fetch the latest data.
+
 ### Getting multiple storage props
 
 <ScopeBadges scope='gameChannels' read />
diff --git a/docs/unity/channels.mdx b/docs/unity/channels.mdx
index f1730f5..d8f3f72 100644
--- a/docs/unity/channels.mdx
+++ b/docs/unity/channels.mdx
@@ -5,7 +5,7 @@ description: Talo Channels add instant interactivity to your game. Channels can
 
 import { ScopeBadges } from '@site/src/components/ScopeBadges'
 
-# Channels
+# Channels and storage
 
 Talo Channels are a way of passing messages between players that are subscribed to a specific topic. Channels can be used for player chats, sending arbitrary JSON to various groups and pushing game updates directly to clients.