---
title: "exists"
canonical: "https://help.vicon.com/space/Shogun16/13339905/exists"
format: markdown
---
# Description

Returns a Boolean of whether or not a module with a name that matches the specified string value exists in the scene.

The exists command is used to query the scene for the existence of a given module or module type. For instance, you may be writing an automatic editing script and are trying to determine whether or not a certain marker, like LUPA (left upper arm) exists or not, in order to determine what method to used for filling in gaps on other arm related markers.

## Functional area

Data editing

# Command syntax

## Syntax

|  |
| --- |
| `exists modPath [-type string] [-priorityOnly]` |

### Arguments

| **Name** | **Type** | **Required** | **Comments** |
| --- | --- | --- | --- |
| `modPath` | string | yes | Name of module to be queried |

### Flags

> Macro (scroll-tablelayout)

| **Name** | **Flag arguments** | **Argument type** | **Exclusive to** | **Comments** |
| --- | --- | --- | --- | --- |
| `type` | 1 | string | — | Type of module for which to check existence |
| `priorityOnly` | 0 | — | — | Search only the priority module |

## Return value

boolean 

> Macro (scroll-pagebreak)

## Examples

```plaintext
// either one returns a value of True if this node exists in the scene
boolean $t = `exists "Actor_1"`; 
boolean $v = exists( "Actor_1" );
```

# Additional information

## Related commands

- [hasKey](https://vicon-help.atlassian.net/wiki/spaces/Shogun16/pages/13341556)
- [isSelected](https://vicon-help.atlassian.net/wiki/spaces/Shogun16/pages/13341607)