You can use the monday.listen software development kit (SDK) method to create a listener that allows subscribing to certain types of client-side events.


typeOrTypesThe type, or array of types, of events to subscribe to.
callbackA callback function that is fired when the listener is triggered by a client-side event.
paramsReserved for future use.


You can subscribe to the following types of events:

contextFired when one of the parameters in the context changes.
settingsFired when a setting value is changed by the user.
itemIdsFired when the board filter changes, which impacts the list of items currently in view.
eventsFired when an interaction takes place with the board/dashboard. We support the following events: new_items, change_column_values, board_communication, new_zoom_meeting_started_by_me, post_resolved. Please note that change_column_values will not trigger for the name column.
filterFired when the Search filter changes.
locationFired when the location value changes.


This method does not have a return value.


Add settings to your views and widgets

Every view or widget in has a set of fields that lets a user customize that view or widget. Our apps framework allows you to add these fields to your custom views and widgets, and then your app can access the values that the user has configured via our SDK.

For example, the Timeline allows users to choose which columns are displayed, and the Chart lets users change the X axis and chart type. You can use any of the 12 fields we support.

To do this, first add a settings field to your feature to get the color value as an input. Then, we'll use the monday SDK to retrieve this setting's value and use it in our view or widget.

Here's a snippet that listens for changes and calls a callback when the settings field is changed by the user:

monday.listen("settings", res => {
  // {"fieldName": "fieldValue", "fieldName2": "fieldValue2"...}

Subscribe to changes in settings and context

const callback = res => console.log(res);
monday.listen(['settings', 'context'], callback);

Listen to changes in your app's context

monday.listen("context", res => {
  // do Something

Subscribe to interaction-based events on the board

const callback = res => console.log(res);
const unsubscribe = monday.listen("events", callback);

// When an item/s are created on the board:
// => { type: "new_items", itemIds: [5543, 5544, 5545], boardId: 3425 }

// When a column value changes for one of the items:
// => { type: "change_column_value", itemId: 12342, value: {...} }

Retrieve the search query in your app

You can also retrieve the entire search query string in your app. With this approach, you can retrieve the search query the user has entered in their board.

You can use either monday.listen('filter') or monday.get('filter') to return the search term(s).

The following example retrieves the search query string:

const callback = res => console.log(res);
monday.listen('filter', callback);
//  {  "method":"listen", "type":"filter", "data": {"term":"hello world" }, "requestId":"vjt8nqrd7"}

Filter your app's data based on the board filter

The SDK lets your app check if the user has filtered any items on their boards. With this approach, you can add flexibility to your app and create a unified experience for your users.

By using monday.listen("itemIds", callback), you can get a list of items that are displayed on the board.

The following example sets up a listener when the user filters data on the board:

monday.listen("itemIds", (res) => {
  console.log( );
  // [12345, 12346, 12347]

Listen to the URL location within an app

The SDK allows you to listen to an app's location when a user modifies it. You can also use the monday.get("location") SDK method to get the location.

// assume the browser URL is[id]=987&foo=bar
monday.listen("location", ({ data }) => {
  console.log("Current URL:", data.href); //
  console.log("Current query:", data.query); // { id: "987" }
  console.log("Current query (stringified):",; // "app[id]=987"


Join our developer community!

We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎