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

# Filesystem: Copy a file

> Copies a file to a specified destination.

Copies a file from one location to another, leaving the original in place. Use this when you want to keep a file where it is but also place a copy somewhere else, for example duplicating an incoming order file into an archive folder, or copying an image to a second filesystem connection. The copy can go to a different directory, a different file name, or even a completely different connection. The data passing through is left unchanged, so this step is purely an action on files.

This documentation describes: [Schema](/schemas/transformer/filesystem-copy-file)

## Fields

**Source filesystem connection**

Required

The filesystem connection that holds the file you want to copy.

See the [filesystem](/references/filesystem) reference.

**Path of the file**

Required

The location of the file to copy on the source connection, including the file name and extension, for example `inbox/order-1042.csv`. You can use [placeholders](/references/placeholders) here to build the path from the data, such as `inbox/&{order.id}.csv`.

**Destination filesystem connection**

Optional

The filesystem connection the copy should be written to. Leave it empty to copy within the source connection.

See the [filesystem](/references/filesystem) reference.

**Destination directory**

Optional

The folder the copy should be placed in. Leave it empty to copy to the root of the destination connection. You can use [placeholders](/references/placeholders) here to route files into folders based on the data.

**Destination filename**

Optional

The name to give the copy, including its extension. Leave it empty to keep the original file name. You can use [placeholders](/references/placeholders) here too.

**When the destination exists**

Optional

What to do when a file with the same name already exists at the destination. Choose Skip to leave the existing file untouched and do nothing (the default), Overwrite to replace it, or Rename to keep both by giving the copy a new name. When you choose Rename, a Rename strategy field appears so you can pick how the new name is generated.

**Rename strategy**

Optional

Only shown when "When the destination exists" is set to Rename. The way a new file name is generated so the copy does not overwrite the existing file, for example by adding an increasing number to the name.

See the [filesystem-ensure-destination](/references/filesystem-ensure-destination) reference.

## Sample data

This step copies a file rather than transforming the data, so there is no before/after to show. The configuration below copies an incoming order file into an archive folder on the same connection, replacing any file already there.

| Field | Value |
| - | - |
| Source filesystem connection | The connection holding the incoming file |
| Path of the file | `inbox/order-1042.csv` |
| Destination directory | `archive/2026/06` |
| When the destination exists | Overwrite |

```json Configuration theme={null}
{
  "prototype": "filesystem-copy-file",
  "parameters": {
    "sourceFilesystem": "import-files",
    "path": "inbox/order-1042.csv",
    "destinationDirectory": "archive/2026/06",
    "onExists": "overwrite"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.