---
title: "deleteCharacters"
canonical: "https://help.vicon.com/space/ShogunPost121/1253738972/deleteCharacters"
format: markdown
---
# Description

Deletes all or selected characters in the scene. Note that the whole character is deleted (i.e. all children), not just the character node.

## Functional area

Data editing

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `deleteCharacters [-all] [-keepLabels]` |

### Arguments

None

### Flags

> Macro (scroll-tablelayout)

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `all` | 0 | — | — | Deletes all characters. Defaults to deleting selected characters. |
| `keepLabels` |  |  |  |  |

## Return value

void

## Examples

```plaintext
// Delete all Characters in the scene
deleteCharacters -all;
```