---
title: Playbook File Handling
slug: playbook-file-handling
docTags: 
createdAt: 2025-08-11T11:13:46.000Z
---

You can use a connector to handle files in playbooks by using a file-handling connector in an action. For example, you can use a connector that ingests an email that contains attachments.

The file is an attachment from an action output.

:::hint{type="danger"}
There is a limit of 500MiB per file.
:::

## Use Files with a File-Handling Connector

To add files with a file-handling connector:

1. Open a playbook (or create/upload a playbook).
2. Click **Add an action**.
3. From **ACTION**, add a title.
4. From the **Action** drop-down menu, select a connector that has the capability to handle files.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/dn4sRenS8vzaJT_l0OsVX_action-connector-file-handle-2.png" size="66" width="1526" height="797" darkWidth="800" darkHeight="418" position="center" indent="2" showCaption="false"}

5. Click **Configure** to map the property values.
   The action window displays with the **Inputs** and **Outputs** tabs.
6. Click **Outputs**.
   For a playbook to pass a file as data, you need to add a file as an action output.
7. Click **+ Promote** next to the attachments.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/pkpRE48KkvQyxTNLbPFvR_promote-file-action-outputs.png" size="66" width="1753" height="743" darkWidth="800" darkHeight="339" position="center" indent="2" showCaption="false"}

8. Click **Apply**.

You have promoted the file to the playbook outputs and you can now apply them to an action or nested playbook.