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

> ## 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.

# selected

### app.selected

Returns whether or not the specified app object has a valid value.

Checking for specific values within multi-value app objects is also supported.

### Input Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| **tokenOrName** | Text | Yes | App object token or name |

### Returns

Type: **Boolean**

Returns whether or not the specified app object has a valid value.

### Examples

```
// check if object [10] is selected
if (app.selected("[10]") === true)
    debug.log("Selected!");
```

```
// check if multi-value object [10] has value 'ABC' selected
if (app.selected("[10|ABC]") === true)
    debug.log("Selected!");
```

### Remarks

This function is useful if you need to test whether or not an app object has a valid value.

Checking for specific values within multi-value app objects is also supported.

          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]