CMS API + Multi-Image fields

Webflow's CMS supports multi-image fields, which allow the storage of up to 25 images + alt text, in a single field.

Through the API, these can be fully managed, including the alt text.

https://developers.webflow.com/data/reference/field-types-item-values#imagerefset--multi-image

Within your CMS item create and update API calls, you can upload new images by referencing them as an array of URLs. The URLs must be public for Webflow to absorb them.

"fieldData": {
  "images": [
    "https://picsum.photos/800/600",
    "https://www.gstatic.com/webp/gallery3/1.sm.png",
    "https://www.kasandbox.org/programming-images/avatars/spunky-sam.png"
  ]
}

If you want more detail, you can use objects, to specify alt as well, and to reference existing fileId's when you are replace only part of the Multiimage array, or re-ordering items;

"fieldData": {
  "images": [
    {
      "alt": "Serene mountain landscape with dramatic clouds at sunset",
      "url": "https://cdn.prod.website-files.com/67b584978f140ef6402c77a0/682c316848481c69d31fcc72_600.jpeg",
      "fileId": "682c316848481c69d31fcc72"
    }
  ]
}

‍

As a tip- any time you’re uncertain, pop some data in and test the GET endpoint. You’ll see the JSON structure. 99% of the time for most RESTful APIs this will match the POST & PATCH structures.

‍

‍