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.

Specifying additional streams to display a card display in

To specify which streams a card should display in, you can specify additional streams from the Delivery settings tab when editing the card. These choices will be applied by default to each new card sent.

You can override the default settings in two ways:

When providing stream IDs like this, the supplied stream IDs will override the streams configured in the card's Delivery settings.

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.