Newsfeed Plugin
The Newsfeed plugin lets you publish posts in channels and show them to users in the app. Use it for internal communication, news, updates, or targeted messages to specific user groups.
When to use this
- You want to publish news or updates that users can read, like, and comment on
- You need several topic areas (channels) within the same feed — for example "HR", "Operations", and "IT"
- Some channels should only be visible to specific users
- You want posts to support images, links, and attachments
- You want to send push notifications when new posts are published
How it works
A newsfeed has three levels:
- Newsfeed — a named container you create in the plugin. An applet can have several newsfeeds.
- Channels — topic areas within a newsfeed. Each channel has its own icon, color, and permissions.
- Posts — the published content in a channel. Users can react and comment if the channel allows it.
To show a newsfeed in the app, add the Newsfeed widget to a page and point it at a newsfeed you've created.
Enable Newsfeed
- Open your applet.
- Go to Plugin Settings.
- Turn on the Newsfeed plugin.
- Save.
Create a newsfeed
- Enable the Newsfeed plugin in the applet.
- Open the plugin's dashboard from the side menu.
- Click Create newsfeed.
- Enter a name.
- Save.
Once the newsfeed is created, you can add channels, manage users, and configure permissions.
Channels
Channels are the topic areas where posts are published. Each channel has its own settings for visibility, comments, reactions, and notifications.
Create a channel
- Open the newsfeed in the plugin's dashboard.
- Click Create channel.
- Enter a name and configure the channel's settings (see below).
- Save.
Channel settings
Private
| Setting | Description |
|---|---|
| Private | When on, the channel is only visible to users with explicit permission. When off, the channel is open to all users in the applet. |
Comments
| Setting | Description |
|---|---|
| Allow comments | Turn on to let users comment on posts in the channel. |
| Allow disable comments per post | When on, the publisher can disable comments on individual posts. |
| Comments depth | How many levels of replies are allowed. 1 = direct comments only, 2 = replies to comments, and so on. |
Reactions
| Setting | Description |
|---|---|
| Allow like | Turn on to let users like posts. |
| Allow disable likes per post | When on, the publisher can disable likes on individual posts. |
Reading receipts
| Setting | Description |
|---|---|
| Allow reading receipts | When on, the system records which users have read each post. The publisher can see a list of read/unread. |
Notifications
| Setting | Description |
|---|---|
| Allow disable notifications | When on, users can choose to mute notifications from the channel. |
| Send to all devices in this applet | Sends a push notification to every device where the applet is installed — not just users who follow the channel. Only shown for open channels. |
Style
| Setting | Description |
|---|---|
| Color | Color used to mark the channel in the feed. Only shown for the Newsfeed plugin. |
| Icon | Icon representing the channel in the feed and the channel picker. |
Advanced
| Setting | Description |
|---|---|
| Permissions for this channel | Opens the permissions view where you can control which users and groups can read, publish, comment, and react in the channel. |
Delete a channel
Click Delete at the bottom of the channel's settings. This removes the channel and all its posts permanently.
WARNING
Deleting a channel cannot be undone. All posts, comments, and reactions are gone.
Users and permissions
Permissions are controlled at two levels:
- On the newsfeed — who can see the feed at all.
- On each channel — who sees the channel, who can publish, comment, and react.
To manage users in a newsfeed, open the newsfeed and select Users in chat or User groups in chat.
TIP
Use user groups rather than individual users when possible — that way you don't have to update permissions when teams change.
Show the newsfeed in the app
Add a Newsfeed widget to a page in the applet. See Newsfeed Widget for the widget's settings.
Example
Scenario: You want to run an internal newsfeed with three channels — General, HR, and IT — where HR and IT are only visible to those teams.
- Enable the Newsfeed plugin.
- Create the newsfeed Internal.
- Create the General channel — open, allow comments (depth
2), allow likes, allow reading receipts. - Create the HR channel — turn on Private, give the HR group read and publish permissions under Permissions.
- Create the IT channel — same setup with the IT group.
- Add a Newsfeed widget to the home page, point it at the Internal feed, and turn on Show all available channels so users can switch themselves.
Now users see a combined feed — HR staff see General + HR, IT staff see General + IT, and everyone else sees only General.
Tips
TIP
Set Comments depth to 1 for a flat comment thread without replies-to-replies. It keeps the discussion easy to scan.
TIP
Use Send to all devices in this applet sparingly — it goes to everyone, even users who don't actively follow the channel. Reserve it for genuinely important messages.
Common mistakes
WARNING
If a user can't see a channel, check the channel's Private setting first, then its Permissions. A private channel needs explicit read permission.
WARNING
Allow disable comments per post requires Allow comments to be on. If comments are off for the whole channel, there's nothing to disable per post.