Field Types & Item Values
This page is a reference for all Webflow CMS field types and the value formats they accept. Use it to:
- Understand each field type’s purpose and behavior
- Learn how to format values when creating or updating items via the API
To retrieve the specific fields used in a collection, call the Get Collection endpoint.
Field Type Names
Some field types may use slightly different names in the Webflow UI. This document uses the API name for each field type.
Plain Text
Stores text without formatting.
Value Format
Example
Rich Text
Stores long-form text with HTML formatting.
Value Format
Example
Code Blocks in Rich Text Fields
The API doesn’t currently support code blocks in Rich Text fields. Passing code blocks will result in an empty string.
ImageRef / Image
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.
Read Value
Write Value
Multi-Image
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.
Read Value
Write Value
VideoLink
Accepts a URL string for videos hosted on platforms like YouTube or Vimeo.
Value Format
Example
Link
Stores a URL.
Value Format
Example
Stores an email address.
Value Format
Example
Phone
Stores a phone number.
Value Format
Example
Number
Stores an integer or a decimal number.
Value Format
Example
Date/Time
Stores a date and time.
Read Value Format
Write Value Format
Example
Switch
Stores a boolean value (true
or false
).
Value Format
Example
Color
Stores a color value. Accepts HEX, RGB, HSL, and named color formats.
Value Format
Example
Accepted formats include:
#RGB
#RGBA
#RRGGBB
#RRGGBBAA
rgb(red,green,blue)
rgba(red,green,blue,alpha)
hsl(hue,saturation,lightness)
hsla(hue,saturation,lightness,alpha)
orchid
,aqua
,black
, etc.transparent
Option
Creates a predefined list of choices for an item.
Create an Option Field
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
.
Create Field Request
Read Field Definition
Write an option value
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.
Value Format
Example
File
Stores a file reference. You can upload a new file from a public URL or use an existing file by referencing its fileId
.
Read Value
Write Value
ItemRef / Reference
Links an item to another item in the same or a different collection.
Create a reference field
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.
Create Field Request
Write a reference value
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.
Value Format
Example
Multi-Reference
Links an item to multiple items in the same or a different collection.
Create a multi-reference field
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.
Create Field Request
Write a multi-reference value
To set multiple references for an item, pass an array of item id
strings.
Value Format
Example
User
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.