---
title: "cutKeys"
canonical: "https://help.vicon.com/space/Shogun110/13075283/cutKeys"
format: markdown
---
# Description

Cuts (deletes) the currently selected keys on the selected nodes.

This command can be used to eliminate a range of problem keys on a group of markers, for instance, or to remove all the animation from the BoneNodes of a skeleton.

## Functional area

Data editing

# Command syntax

## Syntax

|  |
| --- |
| `cutKeys [-all] [-ranges] [-allLayers] [-onMod string]` |

### Arguments

None

### Flags

> Macro (scroll-tablelayout)

| **Name** | **Flag arguments** | **Argument type** | **Exclusive to** | **Comments** |
| --- | --- | --- | --- | --- |
| `all` | 0 | — | ranges | Delete all keys on the selected nodes |
| `ranges` | 0 | — | all | Delete all keys within the selected time ranges on the selected nodes. |
| `allLayers` | 0 | — | — | Cuts key on all layers. Must specify either -all or -ranges options. |
| `onMod` | 1 | string | — | Cut keys only on specified module. |

## Return value

void 

> Macro (scroll-pagebreak)

## Examples

```plaintext
// These commands select all the BoneNodes in the scene, and then 
// remove all the animation from those nodes, resetting the character
// to its base pose.
selectByType BoneNode;
cutKeys -all;
  
// Cuts any on all selected properties of LFHD within the selected
// time ranges
select LFHD;
cutKeys -ranges;
```

# Additional information

## Related commands

- [copyKeys](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075215)
- [copyPattern](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075217)
- [createKey](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075241)
- [delete](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075285)
- [pasteKeys](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075741)
- [setKey](https://vicon-help.atlassian.net/wiki/spaces/Shogun110/pages/13075969)