> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Let chatters upload files using the File Upload block

## Overview\[#UUID-a91b50e1-b945-5492-b9f2-71a5c455c697_id_4402477244563_id_h_01F9CASZZE8BXSGDNRNX1TJXMM]

The File Upload block lets your chatters upload files to your Salesforce
or Zendesk Support team directly from Ada. You place the block in an
Answer with either the Zendesk Ticketing or Salesforce block. Once
triggered, the block initiates the native file system of the chatter's
device, which they'll use to locate and select the file to upload. The
uploaded file attaches to the support ticket.

![](/_fern-files/_img/818c44ec02b9e17e11dc765006deffa05f42c512361c9be94066fd4f41d97f25.webp)

> **Note**
>
> Any files that chatters upload remain available for 24 hours. After
> that, Ada automatically deletes those files, without keeping any
> backups.

### Requirements\[#UUID-a91b50e1-b945-5492-b9f2-71a5c455c697_id_4402477244563_id_h_01F9CBDE6TGM0TPPW464M2KPKE]

File Upload works in conjunction with either of the following features:

* [Zendesk Ticketing app](/scripted/docs/integrate-ada-with-other-tools/use-ada-with-zendesk/create-customizable-email-tickets-using-the-zendesk-ticketing-app)

* [Salesforce Action block](/scripted/docs/integrate-ada-with-other-tools/use-ada-with-salesforce/manage-chatter-information-using-the-salesforce-action-block)

## Configure the File Upload Block\[#UUID-a91b50e1-b945-5492-b9f2-71a5c455c697_id_4402477244563_id_h_01F9CJG35Q768NJCTQH49N5HPJ]

Place the File Upload block in an Answer at the point where the file
upload interaction should occur. Once the block is placed, setting it up
is quite simple.

1. In your **handoff Answer**, Drag and drop the **File Upload** block
   into position, at the point in the Answer where you want the chatter
   to upload the file.

   > **Note**
   >
   > Insert the File Upload block in your handoff Answer at a position
   > preceding the support block. The chatter must upload their file
   > before the support block triggers.

2. In the File Upload block, complete the fields under the
   **Configuration** and **Save Response as Variables** sections. For
   optional fields or variables, click the **drop-down menus** under
   each section.

   <table>
     <thead>
       <tr>
         <th>
           Configuration
         </th>

         <th>
           Description
         </th>
       </tr>
     </thead>

     <tbody>
       <tr>
         <td>
           **Accepted File Types**
         </td>

         <td>
           Enter the extensions of the acceptable file types. Include the
           dot in the extension. Separate multiple items with commas.

           **Example:** .jpg,.png,.pdf,.mp4
         </td>
       </tr>

       <tr>
         <td>
           **Maximum File Size (MB)**
           *\[optional]*
         </td>

         <td>
           Enter a value to set a file size limit in megabytes (MB), up to a
           maximum of 100 MB. Use numbers only.
         </td>
       </tr>
     </tbody>
   </table>

   <table>
     <thead>
       <tr>
         <th>
           Save Response as Variables
         </th>

         <th>
           Description
         </th>
       </tr>
     </thead>

     <tbody>
       <tr>
         <td>
           **File URL**
         </td>

         <td>
           Set a variable to capture the **pre-signed URL**
           of the chatter's uploaded file.
         </td>
       </tr>

       <tr>
         <td>
           **File Data Token**
         </td>

         <td>
           Set a variable to capture the **file data token**,
           which gives your team access to the uploaded file on the Ada server.

           Attach this variable to the File Data Token field in your support
           block.
         </td>
       </tr>

       <tr>
         <td>
           **File Name***\[optional]*
         </td>

         <td>
           Set a variable to capture the **file name** of the
           chatter's uploaded file.
         </td>
       </tr>
     </tbody>
   </table>

3. At the bottom of the Answer, click **Save**.

4. In the handoff block (either the Zendesk Ticketing app or the
   Salesforce Action block), in the **Select Optional Inputs** field,
   enter the file data token variable you set above. Doing so links the
   file upload with the chat handoff, so that your bot knows to include
   the file with the handoff.

## Chatter Experience\[#UUID-a91b50e1-b945-5492-b9f2-71a5c455c697_id_4402477244563_id_h_01FANGNCC1HZ65AHQ2B0QVBZWC]

When the chatter encounters the File Upload block during the course of
the handoff Answer, they are presented with a widget in the chat window.
The widget displays:

* The accepted file types

* The maximum file size allowed

* A link titled **Select file**

![](/_fern-files/_img/b3ce7be1128e0a1ae81bd539c788ee63573c52cc8055f5c1dc1cd6fca075f8b6.webp)

When the chatter clicks the **Select file** link, the native file
navigation view for their device displays. The chatter simply chooses a
file and clicks the execute button, usually titled **Open**. The
navigation view disappears, and the upload widget in the chat window
shows a file icon and the file name. A **Submit File** button also
appears. The chatter clicks this to upload the file. The widget displays
a **File successfully uploaded** message with a friendly green thumbs up
for good measure.

### Cancelling an Upload

The File Upload block uses the Cancel Capture Answer, in case the
chatter chooses not to upload a file. When the Upload File widget
displays, the Cancel Capture Answer's *Never mind* button appears
beneath it. Clicking this cancels the file upload process, and the
handoff flow ends.

Keep the Cancel Capture behavior in mind when adding the File Upload
block to your handoff Answer. In certain circumstances, it may be
necessary to use a Conditional block to display the block to the chatter
only if they explicitly agree or request to upload a file.

## Agent Experience\[#UUID-a91b50e1-b945-5492-b9f2-71a5c455c697_id_4402477244563_id_h_01FANGNJFQH44ZJJAZDPHV4HV6]

The agent experience varies depending on which support platform your
organization uses.

### Zendesk

When a file is shared with your Zendesk Support team, the agent assigned
to the ticket will see the transferred file right on the ticket itself.
From there, they can click to open the file and review its content. The
file appears on the main area of the Zendesk dashboard, below the
transcript at the bottom of the ticket workspace.

![](/_fern-files/_img/9a1e5334754a6bfe243633abe385066005f832afaf9ef9030b63dd928cdf403f.webp)

### Salesforce

The uploaded file attaches to the Salesforce Case created for the
chatter.

On the Salesforce dashboard, go to **Cases**, open the Case ticket, then
click the **Related** tab. The file appears under the Attachments section.

![](/_fern-files/_img/837a7fbff7d07aaa6ce656cc23e5c3cf0839fe598c9ebb0cf7798185ae52fd2d.webp)

#### Related Articles

[Zendesk Ticketing App](/scripted/docs/integrate-ada-with-other-tools/use-ada-with-zendesk/create-customizable-email-tickets-using-the-zendesk-ticketing-app)

[Salesforce block](/scripted/docs/integrate-ada-with-other-tools/use-ada-with-salesforce/manage-chatter-information-using-the-salesforce-action-block)

[Fetch Chat Metadata](/scripted/docs/build-and-maintain-your-bot/work-with-blocks-and-apps/generate-a-chat-transcript-using-the-fetch-chat-metadata-block)

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).