Newsfeed Widget

The Newsfeed widget shows posts from a newsfeed on a page. Users can read, like, and comment on posts, and — if you allow it — publish new ones. Use it when you've created a newsfeed in the Newsfeed plugin and want to surface it in the app.

When to use this

• You've built a newsfeed and want to show its posts on a page
• Users should be able to switch between channels — or only see one specific channel
• You want to combine several channels into a single feed
• You want to show just the latest posts as a teaser on a home page

How it works

The widget binds to a newsfeed and shows its posts. You control:

• Which channels are shown — all, a preselected one, or a list you decide.
• What is shown — full posts, only messages, or only the latest few.
• How publishing works — whether a user can post to several channels at once.

TIP

The Newsfeed plugin must be enabled in the applet. If it isn't, no feeds appear in the widget's dropdown.

Add a newsfeed

1. Enable the Newsfeed plugin in the applet's Plugin Settings.
2. Open the Design editor for your applet.
3. Add the Newsfeed widget to the page.
4. Open the widget settings.
5. Pick a newsfeed under Choose chat.
6. Configure Channels and Messages as needed.
7. Save your changes.

Widget settings

Choose chat

Pick which newsfeed the widget should show. The list contains every newsfeed in the applet.

WARNING

If the list is empty, you haven't created a newsfeed yet. Go to the Newsfeed plugin and create one first.

Channels

The settings under Channels control which channels from the selected feed are shown in the widget.

Show all available channels

When on, the widget shows every channel the user has access to. When off, you choose which channels are available.

Choose preselected channel

Decides which channel opens when the widget loads. Three options:

Option	Description
None chosen	The user starts in a channel picker and chooses for themselves.
Combined	Posts from several channels are shown in one merged feed.
Specific channel	The widget opens directly in that channel.

Only shown when Show all available channels is off.

Show all available channels in the combined news feed

When Preselected channel is set to Combined, turn this on to include every channel the user has access to in the combined feed. Turn it off to limit the combined feed to a specific list you set below.

Choose available channels

Multi-select where you specify which channels are part of the widget. Only shown when Show all available channels is off and Preselected channel is either None chosen or Combined (without "show all" being on).

Show icon

When on, the channel's icon is shown next to each post in the feed.

Messages

The settings under Messages control how posts are shown and published.

Show only messages

When on, posts are shown without the option to write new ones — the widget becomes a read-only view. Use it on pages where the user should only consume content, like a home page with the latest news.

Show only latest

Limits the widget to the N most recent posts. When on, the Number of latest messages field appears so you can set the count.

Allow publish to multiple channels

When on, the user can choose to publish the same post to several channels at once. Useful when the same information should reach several audiences without duplicating work.

Example

Scenario: You want to show the three latest posts from the internal newsfeed on the home page, and have a separate page with the full feed.

1. Create the Internal newsfeed in the Newsfeed plugin with channels General, HR, and IT.
2. Add a Newsfeed widget to the Home page:
   • Pick Internal under Choose chat.
   • Set Preselected channel to Combined, turn on Show all available channels in the combined news feed.
   • Turn on Show only messages and Show only latest, set the count to 3.
3. Add another Newsfeed widget on the News page:
   • Pick Internal.
   • Turn on Show all available channels so the user can switch between channels.
   • Turn on Allow publish to multiple channels.

The home page shows a compact news teaser, the News page gives the full experience with channel switching and multi-channel publishing.

Tips

TIP

Use Show only latest with a low count (3–5) on home pages. It creates a natural "read more" pull toward a dedicated news page.

TIP

For channels that should stay separate — say HR and IT — pick Preselected channel: None chosen and let the user choose. Combined feeds work best when the channels complement each other.

Common mistakes

WARNING

Users only see channels they have permission for. If a user is missing a channel in the widget, check the channel's permissions in the Newsfeed plugin — not the widget settings.

WARNING

Show all available channels in the combined news feed is locked until Preselected channel is set to Combined. If it isn't, the setting appears disabled.

WARNING

Allow publish to multiple channels doesn't grant publish permission — the user still needs publish permission in every channel they want to post to.