Field Types & Item Values
Field Types & Item Values
Field Types & Item Values
This page is a reference for all Webflow CMS field types and the value formats they accept. Use it to:
To retrieve the specific fields used in a collection, call the Get Collection endpoint.
Some field types may use slightly different names in the Webflow UI. This document uses the API name for each field type.
Stores text without formatting.
Stores long-form text with HTML formatting.
The API doesn’t currently support code blocks in Rich Text fields. Passing code blocks will result in an empty string.
Stores a single image. Images must be hosted on a publicly accessible URL to be uploaded via the API. The maximum file size for images is 4MB.
Stores multiple images. Images must be hosted on a publicly accessible URL to be uploaded via the API. The maximum file size for each image is 4MB.
Accepts a URL string for videos hosted on platforms like YouTube or Vimeo.
Stores a URL.
Stores an email address.
Stores a phone number.
Stores an integer or a decimal number.
Stores a date and time.
Stores a boolean value (true or false).
Stores a color value. Accepts HEX, RGB, HSL, and named color formats.
Accepted formats include:
#RGB#RGBA#RRGGBB#RRGGBBAArgb(red,green,blue)rgba(red,green,blue,alpha)hsl(hue,saturation,lightness)hsla(hue,saturation,lightness,alpha)orchid, aqua, black, etc.transparentCreates a predefined list of choices for an item.
To create an Option field, send a POST request to the Create Field endpoint. The request body must include "type": "Option" and a metadata object containing an options array. Each object in the array defines a choice with a name.
To set an option for an item, get the option id of the desired option and pass it as a string. You can get the option id by calling the Get Collection Details endpoint and then searching for the option field and it’s metadata in the fields array.
Stores a file reference. You can upload a new file from a public URL or use an existing file by referencing its fileId.
Links an item to another item in the same or a different collection.
To create a Reference field, send a POST request to the Create Field endpoint. The request body must include "type": "Reference" and a metadata object containing the collectionId of the collection you want to reference.
To set a reference for an item, get the item id of the referenced item and pass it as a string. You can get the item id by calling the Get Items endpoint for the referenced collection.
Links an item to multiple items in the same or a different collection.
To create a Multi-Reference field, send a POST request to the Create Field endpoint. The request body must include "type": "MultiReference" and a metadata object containing the collectionId of the collection you want to reference.
To set multiple references for an item, pass an array of item id strings.
A read-only field containing the unique ID of a Webflow user. This field is used for the “created-by” and “updated-by” properties on an item.