​​The attachments input feature in the workflows editor enables you to include files and documents in various workflow activities. This guide will walk you through the process of adding attachments to your workflows.

Accessing the Attachments Input Component

In the workflows editor, you can access the attachments input component from numerous actions, for example:

• Create a post
• Send a chat message and Send a group chat message
• Create a task and other task-related blocks including approval requests
• Send an email
• Upload to document library

Now it offers three different options for adding attachments:

1. Add Attachment from Magic Variable

This option allows you to include files generated by the workflow itself, e.g. PDF generated from a submitted form and files already hosted by Beekeeper, such as images attached to a form or a user's avatar. To use this option:

1. Within your workflow action, locate the attachments input component.
2. Choose the "From Magic Variables" option.
3. Select the relevant magic variable from the left panel that contains the desired file.
   
   

2. Allow Upload from Computer

With this option, you can upload files directly from your computer to include in your workflow. Here's how to do it:

1. Find the attachments input component within your workflow activity.
2. Select the "From Your Computer" option.
3. Drop one or multiple files by dragging or browsing files. Click the "Upload" button to attach those files. The maximum file size for video is 50 Mb and 10 Mb for other files.
   
   

3. Add URL/Link

The URL/Link input option enables you to add attachments with internal Beekeeper URLs. These URLs should include '/artifacts/' or '/api/2/files/key'. Follow these steps:

1. Locate the attachments input component in your workflow activity.
2. Choose the "From URL/Link" option.
3. Paste the internal Beekeeper URL to a resource or construct it using Magic Variables.

It's possible to use Magic Variables in the URL/Link input which is helpful for constructing a dynamic URL/Link.

You cannot attach files from external sources, i.e., any files from a domain other than your Beekeeper domain. This also applies to SharePoint integration files from the document library.

One of the use cases is adding files from the document library (excluding SharePoint integration files). The link can be copied from the action column and pasted in the attachment input:

Limitations:

While attachments can enhance your workflows, it's essential to be aware of certain limitations:

• Number of Attachments: Number of attachments is limited. You can attach only one attachment to a single task and you can upload only a single file to the document library via one block. For other blocks the number of attachments is normally limited to 50.
• Source Limitations: As it was already mentioned above, attaching files from external sources isn’t possible. This restriction also applies to SharePoint integration files from the document library.
• Attachment Size: The total size of all attachments in the "Send an email" activity cannot exceed 10MB.
• Performance Impact: Large attachments may impact the performance of your workflows, so consider file size when adding attachments.