---
title: "moveClip"
canonical: "https://help.vicon.com/space/Shogun112/31237974/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/Shogun112/pages/31231711)
- [addToClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31236123)
- [copyClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31234183)
- [cropClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31231656)
- [deleteClipData](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31232946)
- [flatten](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31236768)
- [getActiveClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31235976)
- [getActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31232471)
- [getClips](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31239887)
- [offsetClips](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31230792)
- [removeFromClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31233866)
- [removeLayer](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31237688)
- [resetClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31235942)
- [selectClipObjects](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31227959)
- [setActiveClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31228111)
- [setActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31229729)
- [tileClips](https://vicon-help.atlassian.net/wiki/spaces/Shogun112/pages/31229355)