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

# Sending attachments in HoopAI conversations

> Send files via SMS and email in HoopAI, with size limits and troubleshooting tips to ensure reliable attachment delivery.

You can attach files — images, documents, and other media — to both SMS and email messages in Hoop Conversations. Understanding size limits for each channel ensures your attachments are delivered successfully.

<Frame caption="Attaching a file in an SMS conversation — the paperclip icon in the message toolbar">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/evc3PeLCJMLz3iUG/images/conversations-overview-conversation.png?fit=max&auto=format&n=evc3PeLCJMLz3iUG&q=85&s=68082633d34e1b0b20961bf9d3efed54" alt="Conversation attachments" width="1093" height="373" data-path="images/conversations-overview-conversation.png" />
</Frame>

***

## Attaching files in conversations

### SMS / MMS attachments

<Steps>
  <Step title="Open the SMS channel">
    Open a conversation and select the **SMS** tab.
  </Step>

  <Step title="Click the paperclip icon">
    Click the **paperclip** icon in the message toolbar to attach files.
  </Step>

  <Step title="Choose your upload method">
    Select from your computer, media library, or by URL, then add your file.
  </Step>

  <Step title="Send">
    Click **Send** to deliver the message with the attachment.
  </Step>
</Steps>

### Email attachments

<Steps>
  <Step title="Open the email channel">
    Open a conversation and select the **Email** tab.
  </Step>

  <Step title="Click the paperclip icon">
    Click the **paperclip** icon at the bottom of the email composer.
  </Step>

  <Step title="Upload your file">
    Choose a file from your computer or media library.
  </Step>

  <Step title="Send">
    Compose your message and click **Send**.
  </Step>
</Steps>

***

<Frame caption="SMS attachment size limits — JPEG, PNG, and GIF up to 5 MB total with 10 attachments maximum">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/6wlH0ZEykyQqefII/images/conversations-sms-window.png?fit=max&auto=format&n=6wlH0ZEykyQqefII&q=85&s=c0465e24ac1f11501148385f720519e8" alt="SMS MMS window" width="1114" height="584" data-path="images/conversations-sms-window.png" />
</Frame>

## SMS attachment size limits

| Limit                                   | Value             |
| --------------------------------------- | ----------------- |
| Maximum attachments per message         | 10                |
| Maximum total size (text + attachments) | 5 MB              |
| Recommended size for best delivery      | Under 500 KB      |
| Toll-free number limit                  | 600 KB or smaller |

**Supported file types for SMS:** JPEG, PNG, GIF

<AccordionGroup>
  <Accordion title="Troubleshooting SMS attachments">
    * **Verify MMS capability** — check your account settings under Phone Numbers to confirm your number supports MMS.
    * **Reduce file size** — if a message fails, try compressing the attachment or using a lower-resolution image.
    * **Check file type** — only JPEG, PNG, and GIF are supported for SMS attachments.
    * **Toll-free numbers** — keep attachments at 600 KB or smaller due to carrier restrictions.
  </Accordion>

  <Accordion title="Can I send MP4 files via SMS?">
    MP4 files cannot be sent directly via SMS. However, recording a video in the mobile app generates a clickable link instead. Ensure the link matches your domain and client's brand name for carrier compliance.
  </Accordion>
</AccordionGroup>

***

<Frame caption="Email attachments — compose with the paperclip icon, keep total size under 25 MB for Mailgun delivery">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/evc3PeLCJMLz3iUG/images/conversations-email-compose.png?fit=max&auto=format&n=evc3PeLCJMLz3iUG&q=85&s=dc78770ad13918dc20cc0fc1002025d8" alt="Email compose with attachment" width="1189" height="813" data-path="images/conversations-email-compose.png" />
</Frame>

## Email attachment size limits

| Limit                                   | Value                     |
| --------------------------------------- | ------------------------- |
| Maximum email size (body + attachments) | 25 MB (Mailgun)           |
| Recommended                             | Keep as small as possible |

Email servers impose size limits to prevent overload. Exceeding the limit results in bounced emails. Different email providers have different limits — Mailgun supports up to 25 MB total.

<AccordionGroup>
  <Accordion title="Troubleshooting email attachments">
    * **Compress files** — use tools to reduce attachment size before uploading.
    * **Use lower-resolution images** — high-resolution photos are often much larger than necessary for email.
    * **Cloud links instead** — for very large files, upload to a cloud service (Google Drive, Dropbox) and include a download link in your email body.
    * **Error notification** — if an email bounces due to size, you will see an error notification in the Conversations tab indicating the attachment exceeded the allowable limit.
  </Accordion>

  <Accordion title="Can I bypass email size limits?">
    No. Size limits are enforced by email servers and cannot be bypassed. The recommended workaround is to upload the file to a cloud storage service and share a download link in the email instead.
  </Accordion>
</AccordionGroup>