---
title: "listen"
slug: "app-listen"
updated: 2025-11-06T19:06:44Z
published: 2025-11-06T19:06:44Z
canonical: "docs.doc-know.com/app-listen"
---

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

# listen

### app.listen

Registers specified app object(s) to listen for change events.

          Token Syntax

          

This function uses the native app **object token syntax**, which refers to the ID of an object within your app that is enclosed in square brackets.

Example: [10]

### Input Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| **tokensOrNames** | Text | Yes | Comma-separated list of app object token(s) and/or name(s) |

          Listening for All Input Changes

          

If you want to listen for ALL app object changes, you can listen for the wildcard '*' character instead of listing out all object tokens or names. An example is provided below.

### Returns

No return value.

### Examples

```
// register 3 app objects for change events
// (2 objects using object token syntax; 1 object using the object's name)
// when changed by the user, the Ux.Change event will fire
app.listen("[1], [10], favColor");
```

```
// register ALL app objects for change events
// when changed by the user, the Ux.Change event will fire
app.listen("*");
```

### Remarks

When building apps, you will often add **objects** that become part of your app's **visual layout**. These objects are intended for user input.

By using the **app.listen**() function, your scripts can listen for user changes to these inputs and take appropriate action.

It is recommended that you use this function inside a script assigned to the **Ux.Initialize** runtime event. This script only runs once when your app is started, so it is typically the best place to set up your listeners. Then, create a separate script assigned to the **Ux.Change** runtime event to take appropriate action when these inputs change.