# Download File

> `UiPath.Box.Activities.File.DownloadFile`

`UiPath.Box.Activities.File.DownloadFile`

The **Download File** activity uses the Box [Download file](https://developer.box.com/reference/get-files-id-content/) API to download a file (**File Id** and **Version**) to specified folder (**Local file path**). You have the option overwrite an existing file that has the same name (**Overwrite**).

## How it works

The following steps and message sequence diagram is an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the [Setup](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-setup) steps.
2. Add the [Box Scope](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-scope) activity to your project.
3. Add an activity or run an external process that outputs a `File.Id` value (e.g., [Upload File](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-upload-file), [Search for Content](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-search-for-content), etc.).
4. Add the **Download File** activity inside the **Box Scope** activity.
5. Enter values for the **Input** properties.
   * Your input property values are sent in the [Download file](https://developer.box.com/reference/get-files-id-content/) API operation request.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-178992-80d76d59-096cb073.webp)

## Properties

### Common

* **ContinueOnError** - Specifies if you want the activity to continue running when an error is thrown. This field supports only `Boolean` values.
* **DisplayName** - The display name of the activity. This field supports only `Strings` or `String` variables.

### Input

* **File ID** - The ID of the file. This field supports only `Strings` or `String` variables. To get the **File ID** value, add an activity or run an external process that outputs a `File.Id` object (e.g., [Upload File](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-upload-file), [Search for Content](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-search-for-content), etc.).
* **Local file path** - The location where you want to download the file. This field supports only `Strings` or `String` variables. This is a folder location. The file downloaded will use the name of the file as the file name locally.

### Misc

* **Private** - If selected, the values of variables and arguments are no longer logged at Verbose level.

### Options

* **Overwrite** - If *Selected*, the activity overwrites an existing file with the same name. If *Not Selected*, the activity throws an exception if a file with the same name exists in the specified **Local file path**.
* **Version** - The specific version of the file that you want to download. This field supports only `Strings` or `String` variables. If there is a specific version of a file that you want to download, use this property to specify the file version ID.