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

Use this command to add selected modules to the currently active clip or to add specific modules to specific clips.

When modules are added to the specified/active clip they do not carry over any animation from any other clip. The modules exist with only their constant values.

## Functional area

Data manipulators

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `addToClip ["module" ...] [-toClip string]` |

### Arguments

> Macro (scroll-tablelayout)

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `module1` | string | no | Name(s) of the module(s) to add to the clip. You may pass in a string array containing a list of modules to add to the clip. You can also pass in multiple strings. If no strings/arrays are specified, then all Modules will be added to the clip (or selected modules, if you specify the -selected flag. |

### Flags

> Macro (scroll-tablelayout)

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `toClip` | 1 | string | — | Name of the clip you want the modules to be added to. If not specified, then modules will be added to the active clip. |

## Return value

void 

> Macro (scroll-pagebreak)

## Examples

```plaintext
// create a Clip and a Marker
create Clip "clip1";
create Marker "marker1";
 
// create a 2nd Clip
create Clip "clip2";
 
// add marker1 to clip2
addToClip marker1 -toClip clip2;
```

# Additional information

## Related commands

- [addLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737807)
- [copyClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253739720)
- [cropClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736523)
- [deleteClipData](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736978)
- [flatten](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738158)
- [getActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736484)
- [getClips](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737048)
- [moveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736803)
- [offsetClips](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737528)
- [removeFromClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736603)
- [removeLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738515)
- [resetClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736672)
- [selectClipObjects](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253739060)
- [setActiveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736878)
- [setActiveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736878)
- [setActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737913)
- [tileClips](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738014)