---
title: "addLayer"
canonical: "https://help.vicon.com/space/Shogun19/13795750/addLayer"
format: markdown
---
# Description

Create a new layer in the active clip

An error is generated if there is no clip in the scene.

## Functional area

NLE

# Command syntax

## Syntax

|  |
| --- |
| `addLayer "layerName"` |

### Arguments

| **Name** | **Type** | **Required** | **Comments** |
| --- | --- | --- | --- |
| `layerName` | string | yes | The name of the layer to add |

### Flags

None

## Return value

void

## Examples

```plaintext
// Print the name of the active clip
string $clip = `getActiveClip`;
print $clip;
 
// Add new layer
string $name = "new layer";
addLayer $name; 
// Print all layers
string $layers [];
$layers = `getLayers`;
print $layers;
```

> Macro (scroll-pagebreak)

# Additional info

## Related commands

- [addToClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13795768)
- [copyClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13795842)
- [cropClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13795910)
- [deleteClipData](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13795928)
- [flatten](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796004)
- [getActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796014)
- [getClips](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796048)
- [moveClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796356)
- [offsetClips](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796366)
- [removeFromClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796436)
- [removeLayer](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796438)
- [resetClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796460)
- [selectClipObjects](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796502)
- [setActiveClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796538)
- [setActiveClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796538)
- [setActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796540)
- [tileClips](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796766)