Chat Widget

The Chat widget shows a chat on a page so users can send and receive messages directly in the app. Use it when you've created a chat in the Chat plugin and want to present it to users.

When to use this

• You've created a chat and want users to be able to use it
• Users should be able to switch between channels in the same chat
• You want a dedicated page for messaging in the app

How it works

The widget binds to a chat from the applet. It shows the chat's channels and lets users post and read messages in the channels where they have permission.

Settings for individual channels — comments, likes, reading receipts, notifications — are configured on the channel in the Chat plugin, not in the widget.

TIP

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

Add a chat

1. Enable the Chat plugin in the applet's Plugin Settings.
2. Open the Design editor for your applet.
3. Add the Chat widget to the page.
4. Open the widget settings.
5. Pick a chat under Choose chat.
6. Save your changes.

Widget settings

Choose chat

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

WARNING

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

Example

Scenario: You want to give users access to the internal chat on a dedicated page in the app.

1. Create the Internal chat in the Chat plugin with channels General and Leadership.
2. Configure the channels with the right permissions — for example Private on Leadership.
3. Add the Chat page to the applet.
4. Add a Chat widget to the page.
5. Pick the Internal chat under Choose chat.

Users now see the channels they have permission for, and can post in the channels where they have post rights.

Tips

TIP

Place the chat widget on its own page so it gets the full screen. Chat is space-intensive and gets hard to use if it's crowded together with other widgets.

TIP

To limit which channels are shown or pick a preselected channel, manage it through the channels' permissions in the Chat plugin — the chat widget doesn't have channel filters the way the Newsfeed Widget does.

Common mistakes

WARNING

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

WARNING

If a user can see a channel but can't post, they lack post permission. That's controlled by the channel's Permissions — not here in the widget.