Creating Feed Groups

LAST EDIT Nov 16 2021

Feed Types


There are 3 feed types:

Based on these 3 basic feed types you can create your own feed groups.

'Which Feed Groups Should I Create?'


We recommend that you create different feed groups for adding activities, and for consuming activities.

  • Flat are the only feeds that can be followed, and therefore are a good type to setup for adding activities. Flat can also be used to consume activities from other feeds - in a "timeline"-like manner.

  • Aggregated are good for consuming activities in an "aggregated"-like manner. You cannot follow an aggregated feed, but you may on occasion want to add activities to one.

  • The Notification type makes it easy to add notifications to your app. Notifications cannot be followed by other feeds - but you can write directly to a Notification feed.

For example, let’s say you are building a music app similar to Spotify. You may set up the following feeds like so:

  • "notification" (Notification): Displaying notifications from anything a user is following.
  • "user" (Flat): Adding activities from a user that can be followed.
  • "artist" (Flat): Adding activities from an artist that can be followed.
  • "playlist" (Flat): Adding activities from a playlist that can be followed.
  • "timeline" (Flat): Displaying "user", "artist", or "playlist" activities.

'How Do I Create Feed Groups?'


New feed groups can be created in the Feeds section of the Dashboard. By default, we set up four feed groups for your project:

These four groups cover the average use-cases for most applications. However, you can create any custom named feed group that serves your application needs.

Management of feed groups through API is being worked on but it isn't supported at the moment.