What is the correct format to pass an array of URLs to the Multi Image field in Webflow's API for updating?
- Structure the multi-image field as an array of objects using the format
{ "image": "URL" }under the correct field slug. - Ensure all image URLs are publicly accessible and direct, as Webflow requires at least one image and does not process external images.
To update a Multi-Image field using the Webflow CMS API, you need to pass an array of image URL objects, not just plain strings.
1. Use image Key for Each URL
For each image in the array, wrap the URL inside an object with a single key:
image.The correct format is:
```
"multi_image_field_slug": [
{ "image": "https://example.com/image1.jpg" },
{ "image": "https://example.com/image2.jpg" }
]
```
2. Include in CMS Item Update Payload
When making a PATCH request to update a CMS item, structure your body like this:
```
{
"fields": {
"multi_image_field_slug": [
{ "image": "https://example.com/image1.jpg" },
{ "image": "https://example.com/image2.jpg" }
]
}
}
```Replace
multi_image_field_slugwith the actual field slug from your CMS Collection.
3. Image Hosting Requirements
- Webflow only accepts images from publicly accessible URLs.
- If hosting externally, make sure:
- The URL points directly to the image file.
- There's no 403 or access restrictions.
4. Limitations
- You must upload at least one image (cannot be completely empty).
- Webflow does not resize or process external images automatically—you are responsible for format and size.
Summary
To update a Webflow Multi-Image field via API, pass an array of objects like { "image": "URL" } under the field slug. Ensure all image URLs are public and valid.