Skip to main content

Streams and containers

Containers and streams

A stream is a collection of cards. Every card needs to be assigned to at least 1 stream.

A container contains one stream of cards. The container is the object inside your apps that displays cards. Each container references one or two themes.

All cards stream

Every card will always be sent to the All cards stream. If you also want to have cards appear in other streams, you need to specify this for every card.

Create a new stream

Create a new stream by navigating to Configuration > Streams.

Click the New stream button and add a new stream. The new stream appears in the Streams list.

Associate cards with a new stream

Navigate to the Card you want to assign to one or more streams.
Select the Delivery tab, and select the name of the stream(s) you want to send this card to.

Assigning streams to containers

You can choose to have multiple containers in your apps, to show relevant action cards depending on the context. We recommend a unique stream container configuration for each container. This allows you to apply container-specific configurations to each, without affecting the others, and minimising the likelihood of requiring changes in future to your client-side code.

You can do this by navigating to Configuration > Stream containers.

Click the New container button. Give the container a name, set a limit of the cards that can be shown inside the container, add a stream and assign a theme. If you wish, you can also enable dark mode and assign a dark theme. You can read more about themes in the Theme editor tutorial.

Each container can only have 1 stream, but the same stream can be assigned to multiple containers.