---
title: Attachments
slug: admin-guide/attachments
docTags: 
createdAt: 2025-04-07T20:04:52.516Z
---

# Attachments Overview

Your form can include attachments. Attachments enable users to provide documents required or helpful for the agent or approver to resolve the ticket.

Attachments can be mandatory or optional.

For example, the [Employee Travel](docId\:I-4GvaxQAvJhf7HR6NiLe) form includes an optional attachment. The employee can attach the tickets or travel itinerary. For the employee, the attachment option appears as follows:

::Image[]{src="https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/Pm-q7KX8lX8Ar1liSZXxH_image.png" size="40" width="344" height="81" position="center" showCaption="false"}

An example of a required attachment is the [New Hardware](docId\:I-4GvaxQAvJhf7HR6NiLe) form, which requires the requester to upload the manager's approval.

![](https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/waSSaAWuWPbwL4jElHTGD_image.png)

The following configurations are available for attachments:

| Option    | Description                                                                         |
| --------- | ----------------------------------------------------------------------------------- |
| Display   | Enables one or more attachments                                                     |
| Hide      | Disables attachments                                                                |
| Mandatory | Requires at least one attachment                                                    |
| Multiple  | Enables a structured list of multiple attachments, each with its own specifications |

Multiple attachment setup enables you to specify different settings for each attachment. Some attachments can be mandatory and others optional.

For example, employee onboarding can require the new employee to upload certain documents, such as an ID and a signed contract. Other documents can be optional, only applicable to some new employees, such as a work visa. The following figure is an example of a multiple attachment setup for an Employee Onboarding form.

![](https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/Z0yOhFdUKKgXETfOHy8HF_image.png)

In a ticket, this multiple attachment setup appears as follows:

![](https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/jpzEVBgnwImy5nRHEnyG0_image.png)

# Setting up attachments

You can set up attachments at any time.

From the **Forms Setup** page, you can:

- [Add or edit attachments](docId\:zR99CDo3DahGsO0AYNlFq)&#x20;
- [Disable attachments](docId\:zR99CDo3DahGsO0AYNlFq)&#x20;

## Adding or editing attachments

You can add or edit attachment settings at any time.

**To add or edit a form's attachments:**

::::WorkflowBlock
:::WorkflowBlockItem
From the tabs at the top, choose **Attachments**.

![](https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/CJyiBZSPL75ukhtEPLOEz_image.png)
:::

:::WorkflowBlockItem
From the **Attachment Option** dropdown list, choose the option you want.

::Image[]{src="https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/EjV4MmksGxu4c09ZclHXj_image.png" size="50" width="604" height="337" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
If you chose **Multiple,&#x20;**&#x66;ollow the steps for [Setting up multiple attachments](docId\:zR99CDo3DahGsO0AYNlFq). Otherwise, in the **Attachments Label** textbox, enter or edit the attachment label.

![](https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/XvFl4t_FNCT0UEjds_7Pi_image.png)
:::

:::WorkflowBlockItem
At the bottom right of the page, select **Save**.
:::
::::

### Setting up multiple attachments

Any form can have multiple attachments. You can set them up at any time.

**To set up multiple attachments:**

::::WorkflowBlock
:::WorkflowBlockItem
After selecting **Multiple** in **Attachment Options**, at the bottom right of the page, select **Save**.
:::

:::WorkflowBlockItem
Select **Multiple Attachments Setup**.

![](https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/LO2BFWcbpU4PhV91PES40_image.png)
:::

:::WorkflowBlockItem
In the **MultipleAttachments Setup&#x20;**&#x64;ialog that appears, select **Add**.

![](https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/bJnpAyPATW_mMpwtMzlDc_image.png)
:::

:::WorkflowBlockItem
In the **Attachments Setup** dialog that appears, enter or edit the following attachment options and select **Save**.

| Field                      | Description                                                                                                                      | Default value             |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| Subject/Group              | Mandatory field                                                                                                                  |                           |
| Description                | Description of the attachment; mandatory field                                                                                   |                           |
| Shown on                   | Select one or more of:<br />- Create<br />- Update<br />- Close                                                                  | Create, Update, and Close |
| Required on                | Select one or more of:<br />- Create<br />- Update<br />- Close                                                                  | Create, Update, and Close |
| File Types                 | Select a file type for the attachment                                                                                            | All file types            |
| Only when User type        | Select from:<br />- Agent<br />- End user<br />- All                                                                             | All user types            |
| Additional Attribute Label | To display an additional field for the user to fill out when uploading this attachment, enter the label for the additional field |                           |
| Save Destination           | Select from:<br />- Local<br />- OneDrive                                                                                        | Local                     |
| Active                     | Select from:<br />- Yes<br />- No                                                                                                | Yes                       |
| Sequence                   | Select what number this attachment is in the sequence of attachments                                                             | Consecutive               |
| Size Limit                 | Set a limit to attachment size                                                                                                   | None                      |
| Show Valid Until Date      | Select from:<br />- Yes<br />- No                                                                                                | No                        |
:::

:::WorkflowBlockItem
Repeat steps 3 and 4 for as many attachments as you want to add.
:::

:::WorkflowBlockItem
Close the **Multiple Attachments Setup** dialog.
:::

:::WorkflowBlockItem
At the bottom right of the page, select **Save**.
:::
::::

## Disabling attachments

You can disable attachments at any time.

**To disable attachments:**

::::WorkflowBlock
:::WorkflowBlockItem
From the tabs at the top, choose **Attachments**.

![](https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/N4Yq9EVkxsyInaCuzqXly_image.png)
:::

:::WorkflowBlockItem
If your form has one attachment, in the **Attachment Option** dropdown list, select **Hide**.

![](https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/lq5TamdPzLaoswhcKNa_K_image.png)
:::

:::WorkflowBlockItem
If your form has multiple attachments, select **Multiple Attachments Setup**.

::Image[]{src="https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/nCrPYWfxWfgkaez2uEpm6_image.png" size="50" width="829" height="98" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
In the **Multiple Attachments Setup** dialog that opens, select the pencil icon on the row corresponding to the attachment you want to disable.

![](https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/y5jRnhx8XBeScd8uWY413_image.png)
:::

:::WorkflowBlockItem
In the **Attachments Setup** dialog that opens, set the value for **Active** to **No**, select **Save**, and close the **Attachments Setup** dialog.

![](https://api.archbee.com/api/optimize/zEVWKsZtpmpx-RIpALRPL/81UY3XeJcsRoH8tLD7Uwc_image.png)
:::

:::WorkflowBlockItem
Repeat step 5 for all the attachments you want to disable.
:::

:::WorkflowBlockItem
Close the **Multiple Attachments Setup** dialog and select **Save**.
:::
::::



