---
title: "Copy or Move Folder"
slug: "copy-or-move-folder"
updated: 2026-02-23T23:26:46Z
published: 2026-02-23T23:26:46Z
canonical: "docs.visualvault.com/copy-or-move-folder"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visualvault.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Copy or Move Folder

## **Definition**

---

The **Copy or Move Folder** action is used to change the location of existing folders. **Moving** the folder will take the original folder and place it in a new location in the [Document Library](/v1/docs/document-library). **Copying** the folder will create an identical folder and place it in the new location while leaving the original folder in place.

![Copy or Move Folder action](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1771872750946.png)

## **Instructions**

---

To add the *Copy or Move Folder* action to the workflow diagram, drag and drop the action from the list on the left onto a "+" icon in the workflow diagram.

![Copy or Move Folder on the workflow designer](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1771871146817.png)

### Properties

---

The properties of the action can be customized on the step properties panel on the right-hand side of the workflow designer.

![Copy or Move Folder properties panel](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1771871590072.png)

Customize the **Step Name** and **Step Description** to add readability to the workflow action within the workflow designer.

Under **Folder Action**, select either *Copy folder* or *Move folder* to determine the action taken.

This action has two configuration buttons, one to set the **Source Path** (which folder is being relocated) and one to set the **Destination Path** (where it is going).

![Source Path and Destination Path buttons](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1771871391447.png)

### **Source Path**

Click the *Source Path* button to determine which folder will be moved or copied.

![Properties Panel with the Source Path button highlighted](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1771871928224.png)

Configure the Source Path by typing in the *Enter Path* textbox. The path can be a static value, or you can append workflow variables as tokens. Add tokens by using the *Workflow variable* dropdown and *Append Token* button, or by typing the workflow variable name in curly brackets {}.

![Source Path Configurations](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1771872131909.png)

**Folder Path Syntax**

The syntax required for entering the folder path can be found by clicking into the folder in the [**Document Library**](https://portal.document360.io/v1/docs/document-library) and observing how it appears at the top of the main panel.

  

![Document Library with arrow pointing to the folder path /Finance/Pending](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1771538135387.png)

### Destination Path

To establish the path where the folder will be copied or moved to, click the *Destination Path* button.

![Properties Panel with the Destination Path button highlighted](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1771872242702.png)

Configure the Destination Path by typing in the *Enter Path* textbox. The path can be a static value, or you can append workflow variables as tokens. Add tokens by using the *Workflow variable* dropdown and *Append Token* button, or by typing the workflow variable name in curly brackets {}.

![Destination Path configurations screen](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1771872304931.png)

## **Troubleshooting**

The workflow designer will prevent you from publishing a workflow when configurations are incomplete. Here are the most common error messages and how to address them.

#### **![Publishing error message](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1771869956466.png)**

| **Message** | **Fix** |
| --- | --- |
| **Copy or Move Folder:** 'sourcePath' must not be empty. | Configure the [Source Path](/v1/docs/copy-or-move-folder#source-path). |
| **Copy or Move Folder:** 'destinationPath' must not be empty. | Configure the [Destination Path](/v1/docs/copy-or-move-folder#destination-path). |