# Handle Download Block

<figure><img src="/files/xA9ldWDIX7tdyikFYbQp" alt=""><figcaption></figcaption></figure>

This block processes the downloaded file. Please note that the block must be set before the file is uploaded. You need to use this block before the process of downloading a file from the site begins. For example, when the download occurs after clicking on the download button.

<figure><img src="/files/haLGLmm4FA8eJDaftGMo" alt=""><figcaption></figcaption></figure>

Below is a screenshot of the block settings.

<figure><img src="/files/P7JV8iHkdXLRVQ1oHH4I" alt=""><figcaption></figcaption></figure>

Settings of the Handle Download block:

* **Timeout.** Set the workflow pending time for the downloaded file to complete (by default, it is 20000ms - 20 seconds. After the time is up, the workflow continues to execute the block.
* **Download id.** The id of download item to handle. File download ID is a unique identifier that is assigned to the downloaded file. This identifier is used to track the download process, as well as to ensure security and control access to the file.
* **File name.** The name of the downloaded file. Leave this field empty if you want to keep the name unchanged.
* **On conflict.** Indicates what to do if a downloaded file's name conflicts with an existing file.
  * `"uniquify".`The browser will change the file name to be unique..
  * `"overwrite".`The browser will overwrite the old file with the recently uploaded file.
  * `"prompt".`The browser will ask the user to make a choice between uniquify or overwrite.

<figure><img src="/files/VEE1ZDjeAL8GfEASP58O" alt=""><figcaption></figcaption></figure>

* **Wait for the file to be downloaded.** Wait until the file is completely downloaded before continuing to the next block. Setting this setting allows you to access the ability to save information about the uploaded file to a variable or table.

<figure><img src="/files/Ly2pRWrgO0o11WxjOEGa" alt=""><figcaption></figcaption></figure>

* **Assign to variable.** Defines whether the downloaded file's path will be assigned to a variable or not.
* **Variable name.** Variable name to assign a file path.
* **Insert to table.** Defines whether to insert or not the filepath in the table.
* **Select column.** A column to insert the file path.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.goless.com/blocks/browser/handle-download-block.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
