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

# Download File

> Download a file with one click

## What can it do?

Let your users download a file attached to an item in a list or on a list details block. Previously you could do this using the “File” field in a list or list details’ Item Fields section, however now you can also let users do this through a button as well.

## How do I use it?

First, you’ll need to make sure you have an attachment field or a public URL in your datasource that holds the file you want to download. Click on the list or list block that you want users to download from. Then:

1. Click on the Action tab in the topbar of the block’s settings panel

2. Click **Add Item Button**

3. Scroll down in the list of action options to find and click **Download File**
   <Frame>
     <img src="https://mintcdn.com/softr-2b8a27e1/LYEKxIXUMsIQwuYe/actions/images/download-file/image1.png?fit=max&auto=format&n=LYEKxIXUMsIQwuYe&q=85&s=4e056478b8abc92f94adadd4e46fa6b0" alt="Notion image" width="1020" height="1198" data-path="actions/images/download-file/image1.png" />
   </Frame>

In the settings for the action, you have several things to setup as well:

1. Customize what the button label says

2. Choose the field in your datasource that holds the URL or attachment that the user should be able to download.

3. Customize the message that is displayed to the user when the download is completed.
   <Frame>
     <img src="https://mintcdn.com/softr-2b8a27e1/LYEKxIXUMsIQwuYe/actions/images/download-file/image2.png?fit=max&auto=format&n=LYEKxIXUMsIQwuYe&q=85&s=8cfde5c56fa51249de24834f61a4d4f0" alt="Notion image" width="844" height="902" data-path="actions/images/download-file/image2.png" />
   </Frame>
