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

# Send Images via URL

## What It Does[​](#what-it-does "Direct link to What It Does")

This feature automatically converts image URLs into actual images when sending WhatsApp messages. Simply paste an image URL at the start of your message, and it will be sent as an image on WhatsApp with the rest of your text as the caption.

The URL is removed from the message text, and the recipient sees a proper image instead of a link.

***

## Key Benefits[​](#key-benefits "Direct link to Key Benefits")

This feature is particularly useful when working with **AI chatbots**. Many AI chatbots cannot directly send images as attachments, but they can generate or provide image URLs. With this feature, your AI chatbot can simply include an image URL in its response, and the image will be automatically sent to the user on WhatsApp - without needing to handle file attachments.

***

## How It Works[​](#how-it-works "Direct link to How It Works")

### Message Format[​](#message-format "Direct link to Message Format")

Simply start your message with the image URL on the first line, followed by your message text:

```text theme={null}
https://example.com/image.pngYour message text here
```

<Warning>
  Do not use Google Drive links - they will not work with this feature. Use direct image URLs from CDNs or public hosting instead.
</Warning>

**Recommended Image Hosting Platforms:**

* [Imgur](https://imgur.com/) - Free, no account needed, direct image URLs
* [ImgBB](https://imgbb.com/) - Free hosting with simple upload
* [Cloudinary](https://cloudinary.com/) - Professional CDN with free tier (25GB storage)
* [Postimages](https://postimages.org/) - No registration required, direct links

### Requirements[​](#requirements "Direct link to Requirements")

* Image URL must be at the **start of the message**
* URL must end with a valid image extension: `.png`, `.jpg`, `.jpeg`
* Image must be publicly accessible (no authentication required)
* Message text (caption) comes after the URL

***

## Examples[​](#examples "Direct link to Examples")

### Example 1: Basic Image with Caption[​](#example-1-basic-image-with-caption "Direct link to Example 1: Basic Image with Caption")

```text theme={null}
https://example.com/product-photo.jpgHi, how are you?
```

**Result:** Image is sent with "Hi, how are you?" as the caption

***

### Example 2: Multiple Lines of Text[​](#example-2-multiple-lines-of-text "Direct link to Example 2: Multiple Lines of Text")

```text theme={null}
https://example.com/property.jpgBeautiful 3BR home in downtown!Price: $450,000Contact us to schedule a viewing.
```

**Result:** Image sent with all text as caption (preserves line breaks)

***

## Important Notes[​](#important-notes "Direct link to Important Notes")

### Supported Image Formats[​](#-supported-image-formats "Direct link to Supported Image Formats")

* `.png`
* `.jpg` / `.jpeg`

### Limitations[​](#-limitations "Direct link to Limitations")

* Image URL must be **publicly accessible** (no login/authentication required)
* Some servers may block automated image fetching - ensure your CDN/hosting allows it
* Very large images may take longer to send
* URL must end with the image extension (some dynamic URLs may not work)

### Troubleshooting[​](#-troubleshooting "Direct link to Troubleshooting")

**Image not sending?**

* Check that URL ends with `.png`, `.jpg`, `.jpeg`
* Verify the image is publicly accessible (try opening in incognito browser)
* Ensure there are no spaces or special characters in the URL
* Try a different CDN or image hosting service

**Image sending as text?**

* Make sure the URL is on the **first line** of the message
* Check that the URL includes the image extension
* Verify the URL is valid and returns an image (not an HTML page)

***

## FAQs[​](#faqs "Direct link to FAQs")

<AccordionGroup>
  <Accordion title="Can I send multiple images in one message?">
    Currently, only the first URL is converted to an image. If you include multiple URLs, only the first one will be sent as an image, and others will appear as text.
  </Accordion>

  <Accordion title="What if my URL doesn't end in .png or .jpg?">
    The URL must end with a valid image extension (.png, .jpg, .jpeg) for the feature to work. Dynamic URLs without extensions won't be converted.
  </Accordion>

  <Accordion title="Can I use this with custom fields and variables?">
    Yes! You can use custom fields in both the URL and the caption text, making it perfect for personalized automated messages.
  </Accordion>

  <Accordion title="Does this work with password-protected images?">
    No, the image URL must be publicly accessible without authentication. If the image requires a login or token, it won't work.
  </Accordion>

  <Accordion title="Is there a file size limit?">
    WhatsApp has general file size limits for images (typically up to 16MB). Very large images may fail to send or take longer to deliver.
  </Accordion>

  <Accordion title="Can I put the URL in the middle of my message?">
    No, the URL must be at the start of the message (first line) for the feature to work. URLs in the middle or end will be sent as regular text.
  </Accordion>

  <Accordion title="What happens if the URL is broken or the image doesn't exist?">
    If the URL is invalid or the image can't be fetched, the message may fail to send or send as plain text instead.
  </Accordion>
</AccordionGroup>

***

## Support[​](#support "Direct link to Support")

If you need help with the setup or onboarding:

* Email: [**support@messagesync.ai**](mailto:support@messagesync.ai)