June 2, 2023
Introducing Widget Builder

We're thrilled to announce the release of Widget Builder, a powerful new tool that makes it easier than ever to customize your widgets and see your changes in real-time!

With Widget Builder, you have complete control over your widget preferences. You can choose from a range of options to customize the look and feel of your widget, including color schemes, placement, and more. And the best part? You can see your changes live as you make them, so you can be confident that your widget will look exactly how you want it to.

Click here to check it out.

January 2023
January 28, 2023

Widget v2.1.0


Added new loaded event. Includes releases and roadmap items.


Added empty state copy.


BREAKING CHANGE - the ready event doesn’t include release data. Use the new loaded event instead.


The new_release event now triggered for custom triggers as well.


Fixed the scroll position on project and view select.

November 2022
November 30, 2022

We’ve added two new handy methods to our JavaScript Widget.

  • onsetWidget.update() - updates widget options. Useful when updating the widget’s theme to match the embedded site’s look.
  • onsetWidget.reload() - reloads the widget with the new data source and options.
June 2022
June 26, 2022

Developers rejoice. Onset JavaScript SDK is officially here! We have made three different packages available for your disposal. All packages are available via NPM and YARN and include type definitions.


Primarily used in the browser for loading public releases.


Onset API JavaScript interface.


We recommend that you should always be loaded the Widget.js script directly from https://widget.onset.io/widget.js, rather than including it in a bundle or host yourself. If must bundle the Widget code into your application, you can use this package.

June 11, 2022

Widget v2.0.0

We got a ton of new features for you! A few notable ones are:

  • Unread release badges - notify your users of new releases by showing the count in the trigger badge. We check for new releases every five(5) minutes.
  • Widget directions - adjust the direction widget window appears. You can emulate a modal window.
  • Events - subscribe to widget events. Read more about them in our doc.

Added a trigger badge that shows the count of unread releases.


Added new hideBadge attribute to hide the new trigger badge count.


Added new direction and triggerDirection attributes to specify the direction in which the widget should appear.

  • direction - accepted values: left, right, center.
  • triggerDirection - accepted values: left, right.

Added new width attribute to specify the width of the widget. Useful for when using the center direction and simulating a modal window.


Ability to click on the release links.


Added new ready event. Triggered when the widget is loaded and ready to go.


Added new `new_release` event. Triggered when new release is available.


Added new `read` event. Triggered when new release is read.


Fixed the Subscribe button URL


Fixed the project scoping.


Fixed the release change list font size.

June 10, 2022

Widget v1.1.0

We’ve gone dark y’all! We are following up on our previous release and rolling out dark mode for our widget. Unlike the page, dark mode is enabled programmatically, with no toggles.

While embedding the widget, you now have an optional theme attribute that you can pass. It accepts one of three values:

  1. light - light theme
  2. dark - dark theme
  3. auto - auto-detect based on the user’s computer system settings

We default to our usual light theme to avoid shocking your eyes with the new theme. In the future, this property default value be changed to auto.

onsetWidgetSettings = {
  page: 'releases.onset.io',
  triggerText: "🔔 What's New",
  theme: 'dark',

Check out our widget documentation for more configuration options.