# PARTIAL MOVE

> Move items in a partial replica with the Unity Version Control CLI.

## Description

Moves or renames a file or directory.

### Usage

```bash
cm partial move | mv <src_path> <dst_path> [--format=<str_format>]
```

### Options

| Option / Argument | Description                                                                   |
| :---------------- | :---------------------------------------------------------------------------- |
| --**format**      | Retrieves the output message in a specific format. See Remarks for more info. |
| src\_path         | Source item path.                                                             |
| dst\_path         | Destination item path.                                                        |

## Help

### Remarks

This command moves or renames an item in the repository. Changes are done in the local filesystem too.

If the source path is a file, the destination path can be a file or a directory. In the first case, the file will be renamed; otherwise, the item will be moved.

If source path is a directory, the destination path must be a directory.

The item to move or rename must exist.

#### Format

| Option / Argument | Description       |
| :---------------- | :---------------- |
| {0}               | Source path.      |
| {1}               | Destination path. |

### Examples

```bash
cm partial move file.png file-blue.png
```

(Renames the item.)

```bash
cm partial mv .\file-blue.png .\blueFiles
```

(Moves 'file-blue.png' to 'blueFiles'.)

```bash
cm partial move .\design .\marketing
```

(Renames a directory.)
