---
title: "moveClip"
canonical: "https://help.vicon.com/space/ShogunPost121/1253736803/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

> Macro (scroll-tablelayout)

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

### Arguments

> Macro (scroll-tablelayout)

| 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/ShogunPost121/pages/1253737807)
- [addToClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737256)
- [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)
- [getActiveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737428)
- [getActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736484)
- [getClips](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737048)
- [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)
- [setActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737913)
- [tileClips](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738014)