--- title: "Create and publish Announcements: notification levels, display, and analytics" 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." tags: ["User Announcements", "Resource Center"] updated: 2026-11-13T16:34:51Z published: 2026-11-13T16:34:51Z canonical: "help.userflow.com/announcements" --- > ## 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. # Create and publish Announcements: notification levels, display, and analytics This guide shows how to create and publish Announcements in Userflow, choose how noticeable each one is, show them through your Resource Center, and read their analytics. Announcements share product updates, new features, bug fixes and events with your users inside your app. Users read them in your Resource Center, and a notification badge shows when there's something new. To make an update stand out, boost it so it appears as a Pop-out, Modal or Toast. To share it quietly, make it Silent: users only see it when they open Announcements in the Resource Center. Users can also react and comment on an announcement, so you get feedback without a separate survey. ## Step 1: Add content and choose the 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. ![The Enable Read more setting in the announcement builder](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. The background isn't dimmed. - **Modal:** Appears center-screen, dimming the background behind it (the backdrop). 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 2: Turn on Reactions and Comments (optional) Reactions and Comments let users respond to an Announcement with an emoji or a written comment. Both are optional. 1. Select **User feedback** in the left-hand panel. 2. Turn on Reactions, Comments, or both. 3. Turn on confetti for positive reactions, or edit the comment placeholder text, if you want to. ![User feedback settings for Reactions and Comments in the announcement builder](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/image(698).png) For what each setting does and how users see it, see [Reactions and Comments on Announcements: collect feedback and see who responded](https://help.userflow.com/docs/reactions-comments-in-announcements). ## Step 3: Set the announcement time and audience, then publish 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. ## What does "Pending changes" mean on an announcement? **Pending changes** next to an environment, under **Environment overview**, means you've edited the announcement since you last published it there. Users in that environment still see the last published version. To make your edits live, click **Publish**. The label goes away once that environment is up to date. ## Does republishing an announcement make it appear as new? No. Editing an announcement and republishing it does not mark it unread again for users who have already seen it, and that includes changing the notification level. Switching an older announcement from **Boosted** to **Badge** and republishing will not re-notify people who already read it. If you need an update to reach people who saw the original, publish it as a new announcement. ## Add a button to an announcement You can add a button to an announcement to send readers somewhere specific, such as a page in your app, a signup form or a Flow. 1. Open the announcement and click into the **Content** field. 2. In the toolbar, click **+** and select **Button (to click on)**. 3. Enter the button label and choose what the button does. 4. Preview the announcement, then click **Publish**. The same **+** menu also inserts an Attribute, Image, Embed, Columns, or a Container. **Note:** this works differently from banner embeds, which have a visible **Add button** control beneath the banner. In an announcement, the button lives in the Content field's insert menu. ## Build an announcement around a clickable image To show an image that sends people somewhere, build it from two blocks in the **Content** field rather than looking for a single image-button block: 1. Click **+** and insert an **Image**. 2. Click **+** again and insert a **Button (to click on)** beneath it. 3. Set the button's label and what it does. Use **Columns** or a **Container** if you want the image and button grouped in a single panel. ## How do I show a Pop-out announcement without a notch? A Pop-out announcement is drawn as a speech bubble tied to the Resource Center launcher, so it has a notch pointing at the launcher. To show it without the notch, either: - Choose **Toast** or **Modal** instead. Neither is tied to the launcher, so neither has a notch. - Keep the Pop-out and set your Resource Center's **Launcher type** to **None**. Boosted announcements then appear in the position you set, with no notch and no anchor. See [Resource Center Implementation Guide](https://help.userflow.com/docs/resource-center). ## Show an announcement to one product instance or region 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 a condition 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. You don't need a separate announcement for each instance. **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, however many instances you're running. ## Add the Announcements block to your Resource Center An Announcement only shows if a published Resource Center contains an Announcements block. 1. Select **Resource centers** from the sidebar in Userflow. 2. Select your Resource Center or [create a new one](https://help.userflow.com/docs/resource-center). 3. Add an **Announcements** block with **Add block**. 4. Choose which announcements appear in the block: all of them, or filtered by tags or other criteria. 5. Drag the block to where you want it in the Resource Center. 6. **Publish** the Resource Center. Without a published Resource Center that has an Announcements block, your announcements are created but never shown to users. ## Where do announcements appear? Every announcement, including the boosted **Pop-out**, **Modal** and **Toast** formats, is shown through a Resource Center. For an announcement to display, its Resource Center must contain an **Announcements block** and be **published**. If that Resource Center is unpublished, the announcement won't appear, even as a Toast or Modal, however it's targeted. | Announcement format | How it displays | Needs a published Resource Center with an Announcements block? | | --- | --- | --- | | **Pop-out** | A speech bubble from the Resource Center launcher | ✅ Yes | | **Modal** | Center-screen overlay that dims the background | ✅ Yes | | **Toast** | Slides in from a side or bottom corner of the screen | ✅ Yes | ## Which announcement formats dim the background? Only **Modal**. It puts a dimmed backdrop behind the announcement to hold attention on it. **Pop-out** and **Toast** both appear over your app with the background untouched, so there's no backdrop to turn on for them. If you want a boosted announcement with a dimmed background, choose Modal. The **Add backdrop** switch in Themes is a different setting. It applies to steps inside a Flow, not to announcement formats, so turning it on won't add a backdrop to a Pop-out. ## Which theme applies to an announcement? It depends on where the announcement is showing: - **Inside the Resource Center** (opened from the Announcements block): it uses the **Resource Center's theme**, including that theme's custom CSS. - **On its own as a Pop-out, Modal, or Toast:** it uses the theme set on the announcement. Because of this, custom CSS can look right on a boosted announcement but seem to stop working when you view the same announcement inside the Resource Center, including in Preview. **To style announcements inside the Resource Center**, add the CSS to the Resource Center's theme: 1. Open the Resource Center and check which theme it uses. 2. Go to **Settings > Themes** and select that theme. 3. Add your rules under **Custom CSS**, then click **Save theme**. If you want the same look in both places, add the CSS to both themes. ## Show announcements without a visible Resource Center launcher If you want announcements to appear without showing a Resource Center launcher in your app, do **not** unpublish the Resource Center. Instead, keep it published and set its **Launcher type** to **None**. The Resource Center stays active so your announcements keep displaying, but no launcher button is rendered. See [Customize how your Resource Center is launched](https://help.userflow.com/docs/resource-center#customize-how-your-resource-center-is-launched) for all launcher types. ## Where do boosted announcements appear if you use a custom launcher or no launcher? Your Resource Center can open from an element in your app, such as a button, icon or menu item, instead of the default Userflow button. It can also have no visible launcher, with **Launcher type** set to **None**. Boosted announcements work with any of these. With a custom element, boosted announcements appear at that element. With **None**, they appear in the position you set for them on screen. When you change the launcher, check that boosted announcements don't cover other parts of your app. ## What do users see when you publish an announcement? When an announcement is published, users see a notification badge with the number of unread announcements on the Resource Center launcher. The Announcements block inside the Resource Center shows the same badge. ![Unread announcements badge on the Resource Center launcher](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/rc-launcher-unread-badge.png) ![Resource Center open with the Announcements block](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/rc-open.png) ![List of announcements in the Resource Center](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/announcements-list.png) If an announcement is a **Pop-out**, it appears as a speech bubble from the Resource Center launcher. ![A Pop-out announcement shown as a speech bubble from the Resource Center launcher](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/popout.png) If an announcement is a **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 turn on auto-dismiss so it disappears after a short time. ![A Toast announcement in the corner of the screen](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/toast.png) If an announcement is a **Modal**, it appears in the center of the screen to get the user's full attention. The user usually has to interact with it or dismiss it before carrying on. ![A Modal announcement in the center of the screen with the background dimmed](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/modal.png) ## What order do announcements appear in? Clicking the Announcements block in the Resource Center opens the list of announcements. Unread announcements come first, newest to oldest, followed by announcements the user has already read. Userflow marks announcements as seen when users scroll through them. ## What happens when several boosted announcements are due at the same time? Announcements don't have a **Priority** setting like flows do. When several boosted announcements are due for a user at the same time, Userflow shows only one at a time: the one with the most recent announcement time. If two have exactly the same announcement time, which one shows is random. To control which one shows, give each announcement a different announcement time when you set it ("Step 3: Set the announcement time and audience, then publish"). Silent announcements make no visible change when they arrive, and the unread badge on the Resource Center launcher counts each new announcement. ## Announcement not showing? Quick checklist If a published announcement isn't appearing for users, check these in order: 1. **Is the Resource Center published?** Every format, including Pop-out, Modal and Toast, needs a **published** Resource Center that contains an **Announcements block**. An unpublished Resource Center is the most common cause of zero views. 2. **Does that Resource Center actually contain an Announcements block?** A published Resource Center with no Announcements block won't surface announcements. 3. **Is the announcement time in the past?** A future **Announcement time** means it won't show until then. 4. **Do your targeting conditions match the user?** Check the "Only show announcement if" conditions against the user's attributes (check data types: the string `"true"` isn't the same as the boolean `true`). 5. **Was it set to Silent?** Silent announcements don't pop up. Users only see them by opening the Resource Center. 6. **Has the user already seen it?** Once viewed, it won't re-surface as unread. ## Announcement analytics: views, reactions, and comments Announcement analytics show how many users viewed each announcement and, if you turned on Reactions and Comments, how many reacted or commented. ![Announcement analytics chart with views, reactions and comments stacked](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/image(709).png) At the top of the analytics panel are three totals: - **Views:** how many users have seen the announcement - **Reactions:** total reactions submitted - **Comments:** total comments submitted The chart stacks the three: Views at the base (blue), Reactions above (purple) and Comments on top (green). It shows how many users viewed an announcement and how many went on to react or comment, so you can compare announcements over time. Switch between **Day**, **Week** and **Month** to change the time scale. Each announcement shows its own totals for Views, Reactions and Comments. Your dashboard shows the same three metrics added up across all announcements. Unpublishing an announcement keeps its analytics, the same as for flows and other content. See [Rename, duplicate, or delete content in Userflow](https://help.userflow.com/docs/delete-and-duplicate-content). To see which users reacted or commented, see [Reactions and Comments on Announcements: collect feedback and see who responded](https://help.userflow.com/docs/reactions-comments-in-announcements#filtering-to-see-who-commented-or-reacted). ## Can I see how many people clicked a button in an announcement? Announcement analytics report **Views**, **Reactions** and **Comments**, but not clicks. There is no built-in click or click-through metric, so a button you add to an announcement won't show clicks in the announcement's own analytics. To measure whether people acted, track the click as an event instead: 1. Give the button a **Track event** action and select or create an event. 2. Read that event in [Chart Builder](https://help.userflow.com/docs/chart-builder), filtered to the period the announcement ran. This gives you the click count the analytics panel doesn't, and lets you compare it against the announcement's Views. See [Track flow button clicks](https://help.userflow.com/docs/track-flow-button-clicks) for what event tracking does and doesn't cover in announcements. ## Can I bring announcements in from another tool? Userflow Announcements can't be synced from another tool. There's no built-in connection that keeps announcements in step with an external source, such as HubSpot, a changelog or a feed. The Userflow REST API and webhooks can't create announcements either. To create announcements from content you already have, use the userflow-announcement-creator skill with the Userflow MCP. It takes a Notion page, Jira issue, Google Doc or public URL and turns it into an unpublished announcement. You then review it and publish it in Userflow. See [Draft in-app announcements with AI using the userflow-announcement-creator skill](https://help.userflow.com/docs/userflow-announcement-creator). ## Related articles - [Reactions and Comments on Announcements: collect feedback and see who responded](https://help.userflow.com/docs/reactions-comments-in-announcements) - [Resource Center Implementation Guide](https://help.userflow.com/docs/resource-center) - [Track flow button clicks](https://help.userflow.com/docs/track-flow-button-clicks) ## Related - [Resource Center](/resource-center.md)