---
title: "Announcements"
slug: "announcements"
description: "Update users with Announcements in Userflow! Highlight features, fixes, and events with badges and popouts for better visibility in your resource center."
updated: 2026-05-13T16:01:31Z
published: 2026-05-13T16:01:31Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.userflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Announcements

Announcements let you share product updates, new features, bug fixes, events, and more. They appear in your product's standard or custom Resource Center, and Userflow displays each Announcement with a notification badge when new content is available. For updates that require greater visibility, you can boost any announcement to make it stand out and capture users' attention. If you prefer to share an update discreetly, select the Silent option, and users will only see the Announcement when they actively access Announcements in the Resource Center.

You can also go beyond one-way communication by using Reactions and Comments to let users respond directly to your Announcements, providing qualitative feedback and sentiment data without the friction of a separate survey.

## How to create and publish an Announcement

### Step One: Add content and set the in-app notification level

1. Select **Announcements** from the sidebar and click **Create announcement**.
2. Enter a **Name** and click **Create announcement**.
3. For lengthy content, select **Enable Read more** to split the content into two parts and display a **Read more** button. Edit the button label if needed. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/image(696).png)
4. Choose **Notification level**:
  1. **Silent:** For past announcements; doesn't appear as unread or affect the unread counter.
  2. **Badge:** Displays a notification badge (i.e., an unread counter) on the resource center launcher, suitable for regular updates.
  3. **Boosted:** More prominent announcement formats, suitable for high-impact messages. Within Boosted, you can choose:
    - **Pop-out:** Slides or fades in from an edge or corner, drawing moderate attention.
    - **Modal:** Appears center-screen, dimming the background. Best for critical actions or urgent messages.
    - **Toast:** Brief notification that slides in from the side or bottom corner. Great for quick updates that don't need user interaction.

### Step Two: Set user feedback options

You can allow your users to contribute feedback directly on your [Announcements](/userflow/docs/announcements) with **Userflow Reactions and Comments**. *Learn more about Reactions and Comments in the help article,*[*User Feedback: Reactions and Comments*](/userflow/docs/reactions-comments-in-announcements)*.*

1. Select **User feedback** in the left-hand panel and select the options on the right-hand panel.
2. Enable Reaction and Comment options as desired.
3. Enable delightful confetti for reactions, if desired, or edit placeholder copy for comment options. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/image(698).png)

### Step Three: Set publishing options and publish the Announcement

1. Set **Announcement time** for immediate or scheduled posting. If you enter a future time, the announcement won't be visible to users until then.
2. Use the '**Only show announcement if**' option in the left-hand panel to target specific users.
3. **Preview** the announcement in the right-hand panel, then click **Publish** when ready.

## Advanced targeting: multi-instance example

### Targeting by product instance without duplicating announcements

If your product runs multiple instances (e.g., separate environments, regions, or tenants), you can use a single announcement and target it to specific instances using an entity filter on a company attribute — without creating a separate announcement for each instance.

**Scenario:** Your product has 5 regional instances (US, EU, APAC, etc.). You want to announce a new feature to US instance users only.

**Setup:**

1. In your Userflow.js implementation, pass an instance or region identifier as a company attribute when calling `userflow.group()`:

```plaintext
userflow.group(companyId, {
  product_instance: "us-production"
})
```
2. In the announcement builder, open the **Only show announcement if** panel (left-hand sidebar).
3. Add a condition: **Company → product_instance → is → "us-production"**
4. Publish the announcement.

Only users in companies where `product_instance = "us-production"` will see it. Users in other instances won't see the announcement — no duplicate announcements, no complex logic.

**For multiple instances:** To target multiple instances at once (e.g., US + EU but not APAC), use **"is one of"** as the operator and add each instance value to the list.

**Why this works:** The "Only show announcement if" conditions evaluate company-level attributes for each user in real time. As long as your app correctly sets the `product_instance` attribute via `userflow.group()`, Userflow handles the targeting automatically — regardless of how many instances you're running.

> *Reviewer note (KB Manager): the "Advanced targeting: multi-instance example" section above was added per the May 6, 2026 staging Doc. All other content has been preserved verbatim from the prior published version.*

## Where announcements appear

Different announcement types have different display requirements:

| Announcement Type | Display Requirements | Can appear without Resource Center? |
| --- | --- | --- |
| **Modal** | Appears as an overlay anywhere in your app | ✅ Yes — appears independently |
| **Toast** | Appears as a notification anywhere in your app | ✅ Yes — appears independently |
| **Banner** | Appears as a banner anywhere in your app | ✅ Yes — appears independently |
| **Pop-out** | Appears in your Resource Center | ❌ No — requires an Announcement block in your Resource Center |

> [!NOTE]
> Important
> 
> Pop-out announcements will **not** be visible to users unless you've added an **Announcement block** to your Resource Center. Modal, toast, and banner announcements don't have this requirement — they can appear anywhere in your app based on their targeting rules.

### Setting up pop-out announcements

1. Create your pop-out announcement
2. In your Resource Center builder, add an **Announcement block**
3. Configure which announcements appear in that block (all, or filtered by tags/criteria)
4. Publish your Resource Center

Without step 2, your pop-out announcements will be created but never displayed to users.

## Boosted Announcements & Custom Resource Center Launchers

When you configure your Resource Center, you can choose an element in your app (e.g., a button, icon, or menu item) instead of the default Userflow button to launch the Resource Center. You can also opt not to anchor your Resource Center with any visible element by configuring it with the launcher type, 'None.' These options give you the flexibility to customize your users' experience so they can work seamlessly in your app.

Boosted Announcements will behave consistently, whether or not you use a custom launcher, no launch trigger, or the Userflow default. If you choose a custom element in your app, Boosted Announcements will appear with that element. If you choose 'None' as a launcher type, Boosted Announcements will appear in the place you configure them to appear on screen. Ensure Boosted Announcements don't interfere with other elements of your app when you customize the launcher experience.

## Add the Announcements block to the Resource Center

1. Select **Resource centers** from the sidebar in Userflow.
2. Select your resource center or [create a new one](/userflow/docs/resource-center).
3. Add an **Announcements** block via **Add block**.
4. Drag and drop the block to position it in the desired location in the Resource Center.
5. **Publish** the updated Resource Center.

### How Announcements display

Users will see a notification badge showing the number of unread announcements in the resource center launcher.

![Notification badge](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/rc-launcher-unread-badge.png)

Inside the resource center, the Announcements block also displays this notification badge.

![Open resource center](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/rc-open.png)

Clicking it reveals a list of announcements, with unread ones prioritized. Userflow marks announcements as seen when users scroll through them.

![Announcements list](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/announcements-list.png)

If an announcement is set to **Popout**, it appears as a speech bubble from the launcher.

![Popout](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/popout.png)

If an announcement is set to **Toast**, a small notification slides in from the side or bottom corner of the screen. By default, it stays on-screen until the user dismisses it, but you can enable an auto-dismiss feature to make it disappear after a short time.

![Toast](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/toast.png)

If an announcement is set to **Modal**, it displays in the center of the screen, ensuring the user's full attention. The user must typically interact with or dismiss the modal before proceeding.

![Modal](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/modal.png)

### Announcement Analytics

Your Announcement analytics have been updated. Once you start collecting Reactions and Comments, you'll see a new stacked bar chart that brings all your engagement metrics together in one view.

![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/image(709).png)

At the top of the analytics panel, you'll see three summary metrics at a glance:

- **Views** — how many users have seen the announcement
- **Reactions** — total reactions submitted
- **Comments** — total comments submitted

These are plotted together in a single chart, stacked in this order:

1. **Views** at the base (blue)
2. **Reactions** above views (purple)
3. **Comments** on top (green)

> *Metrics are stacked to show the most accurate data.*

This makes it easy to see not just how many users viewed an announcement, but how many took the extra step to engage — and in what way. You can quickly spot whether a particular announcement drove more emotional reactions, more detailed written feedback, or both, and compare that across announcements over time. Toggle between **Day**, **Week**, and **Month** views to track engagement trends at the granularity that works for you.

Each announcement shows its own totals for Views, Reactions, and Comments. On your dashboard, you'll see the aggregate across all announcements — the same as before, now with Reactions and Comments added as two new metrics.

## Related

- [Resource Center Implementation Guide](/resource-center.md)