Collections

LAST EDIT Nov 04 2024

Collections enable you to store information to Stream. This allows you to use it inside your feeds, and to provide additional data for the personalized endpoints. Examples include products and articles, but any unstructured object (e.g. JSON) is a good match for collections.

Collection entries can be embedded inside activities and used to store nested data inside activities. When doing so, Stream will automatically enrich your activities with the current version of the data (see later section). Collection endpoints can be used both client-side and server-side except the batch methods that are only available server-side.

Adding Collections

Copied!

This method allows you to create a new entry on a named collection.

Parameters

Copied!
nametypedescriptiondefaultoptional
collectionstringThe name of the collection-
entry_idstringThe id of the entry, if not given an ID will be generated by Stream.-
dataobjectThe data related to the user-

The max size of a collection can not exceed 50kB

Retrieving Collections

Copied!

After adding an entry to a collection, you can also retrieve it easily by its ID.

Parameters

Copied!
nametypedescriptiondefaultoptional
collectionstringThe name of the collection-
entry_idstringThe id of the entry-

Removing Collections

Copied!

An entry can also be removed from a collection with its ID.

Parameters

Copied!
nametypedescriptiondefaultoptional
collectionstringThe name of the collection-
entry_idstringThe id of the entry-

When you delete an entry from a collection any references will be converted to a missing reference error when reading feeds with enrichment.

Updating Collections

Copied!

A collection's entry data can be updated. Updates are propagated instantly to all activities embedding the entry.

Parameters

Copied!
nametypedescriptiondefaultoptional
collectionstringThe name of the collection-
entry_idstringThe id of the entry-
dataobjectThe data related to the user-