---
title: "moveClip"
canonical: "https://help.vicon.com/space/Shogun17/13537074/moveClip"
format: markdown
---
# Description

Moves the specified clip under another specified clip.

Useful when you are trying to organize your clips in a particular required structure.

## Functional area

Data manipulators

# Command syntax

## Syntax

|  |
| --- |
| `moveClip "moveClip" ["insertAfterClip"] [-up] [-down]` |

### Arguments

| **Name** | **Type** | **Required** | **Comments** |
| --- | --- | --- | --- |
| `moveClip` | string | yes | The clip that you want to move |
| `insertAfterClip` | string | yes | The clip that you want the moveClip to be located under in the clip list. |

### Flags

> Macro (scroll-tablelayout)

| **Name** | **Flag arguments** | **Argument type** | **Exclusive to** | **Comments** |
| --- | --- | --- | --- | --- |
| `up` | 0 | — | down | Moves the clip up from its current position in the clip list. Will error if the clip is already at the top of the clip list |
| `down` | 0 | — | up | Moves the clip down from its current position in the clip list. Will error if the clip is already at the bottom of the clip list |

## Return value

void 

> Macro (scroll-pagebreak)

## Examples

```plaintext
// This snippet creates 3 Clips then moves clip_C under clip_A
create Clip "clip_A" "clip_B" "clip_C";
moveClip clip_C clip_A;

// This will move clip_B to the top of the list
moveClip clip_B -up;
```

# Additional information

## Related commands

- [addLayer](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13537675)
- [addToClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13537691)
- [copyClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13537597)
- [cropClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13537599)
- [deleteClipData](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13536455)
- [flatten](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13536537)
- [getActiveClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13536543)
- [getActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13536541)
- [getClips](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13536339)
- [offsetClips](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13536932)
- [removeFromClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13536946)
- [removeLayer](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13536944)
- [resetClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13536972)
- [selectClipObjects](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13537266)
- [setActiveClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13537290)
- [setActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13537244)
- [tileClips](https://vicon-help.atlassian.net/wiki/spaces/Shogun17/pages/13537110)