Blog

What's new widget: add release notes inside your product

A "What's new" widget is a small notice inside your product, such as a popup, a panel or a bell, that tells users about the latest release. It reaches people while they are already using the product, which is where a changelog on a separate page is easy to miss.

This guide covers when a widget is worth adding, what to put in it, the layouts you can choose from, and how to avoid annoying the people you want to inform.

Why an in-app notice works

Most users never visit a changelog page. They open the product, do their job and leave. A notice in the product puts the news where their attention already is, at the moment a new feature could matter to them. It also gives you a place to explain a change that would otherwise generate support questions, such as a moved button or a new default.

What to put in it

  • The headline change in one sentence, written for a user, not for the team.
  • At most a few more lines for other changes. If it needs scrolling, it is too long.
  • A link to the full changelog page for people who want more.
  • A date or version, so users know whether they have seen it.
feat: add pdf export (#142)Changelog · developers## 1.2.0 - 2026-10-12### Added- Report PDF exporter (#142)Complete, dated, terseRelease notes · usersAcme App 1.2You can now save any reportas a PDF from the toolbar.Curated, friendly, explains
One change, two audiences, two voices.

The figure shows why the wording matters: the same change reads very differently as a developer entry and as a customer sentence. A widget is customer space, so use the second voice. The comparison of changelog and release notes explains the difference.

Choosing a layout

  • Popup. The most visible option. Use it sparingly, for changes most users should see once.
  • Dropdown. Opens from an element you already have, such as a bell or a "What's new" menu item, and only when the user asks.
  • Side panel. Room for several recent versions, useful for products that ship often.
  • Launcher. A small floating button with an unread marker. It stays out of the way until there is something new.

Avoid annoying your users

  • Show a popup once per release, and remember that the user has seen it.
  • Do not block the screen. Let people dismiss the notice with one click or the Escape key.
  • Skip trivial releases. A notice for every bug fix teaches people to ignore it.
  • Make sure the widget cannot break your page. It should not change your layout or conflict with your own styles.

A short checklist before you add one

  1. Decide who should see the notice: every user, or only people who have used the affected feature.
  2. Pick the layout that matches how often you ship. Frequent releases suit a panel or launcher, rare big releases suit a popup.
  3. Write the text from the changelog entry, then shorten it. If you cannot say it in two sentences, link to the page.
  4. Test it on a small screen. A notice that covers the page on a phone is worse than no notice.
  5. Check that it respects your users' choices, for example by not tracking them without consent.

Keep the widget and the changelog in sync

The worst version of this feature is a widget that says one thing while the changelog page says another. Write the release text once and publish it to both places. The guide to public changelog pages covers the page side of that setup.

ReleaseTale publishes a saved changelog as a hosted page and as a What's new popup from the same text. The Free plan includes the popup with a badge, and Pro adds all layouts and triggers, your own domain and brand colors, and removes the badge. See the changelog examples to compare the customer and developer voices before you decide what to show.

Frequently asked questions

What is a What's new widget?

It is a small notice inside a product, such as a popup, panel or bell, that tells users about the latest release while they are using the product.

When should I show a What's new popup?

Once per release, for changes most users should see, and never for trivial fixes. Remember that the user has seen it, and let them dismiss it with one click.

What is the difference between a widget and a changelog page?

A changelog page is a destination users must visit. A widget brings the news to them inside the product. Use both, written from the same release text so they never disagree.

Related articles