Items | Webflow Developer Documentation

Items are the actual content in your CMS collections. Use Items tools to create blog posts, add products, manage team members, and perform all CRUD (Create, Read, Update, Delete) operations on your content.

When to use

Use Items tools to:

Create content: Add new blog posts, products, or any collection items
List existing items: View all items in a collection with filtering and sorting
Update content: Modify existing draft items
Publish content: Make draft items live on your site
Delete content: Remove items from collections
Bulk operations: Create, update, or delete multiple items efficiently
Content migration: Transfer content from other systems

Tool details

Tool name: data_cms_tool

Available actions

List collection items

List items in a collection with optional filtering, sorting, and pagination.

Action: list_collection_items

Parameters:

Parameter	Type	Required	Description
`collection_id`	string	Yes	Collection to list items from
`request`	object	No	Filtering, sorting, pagination options

Request options:

1 {
2   "offset": 0,
3   "limit": 100,
4   "sort": [{"fieldSlug": "publish-date", "direction": "desc"}],
5   "filter": {"fieldSlug": "status", "value": "published"}
6 }

Returns: Array of items with all field data

Example usage:

List all blog posts sorted by publish date, newest first

Use filtering and sorting to find specific items efficiently, especially in large collections.

Create collection items

Generate new items as drafts in a collection.

Action: create_collection_items

Parameters:

Parameter	Type	Required	Description
`collection_id`	string	Yes	Collection to create items in
`request`	object	Yes	Item data including field values

Request object:

1 {
2   "fieldData": {
3     "name": "My Blog Post",
4     "slug": "my-blog-post",
5     "post-body": "This is the content...",
6     "publish-date": "2025-11-24T10:00:00Z"
7   },
8   "isDraft": true
9 }

Returns: Created item with ID and all field data

Example usage:

Create a new blog post titled "Getting Started with Webflow" in collection [collection_id]

Items are created as drafts by default. Use publish_collection_items to make them live.

Update collection items

Modify existing draft items in a collection.

Action: update_collection_items

Parameters:

Parameter	Type	Required	Description
`collection_id`	string	Yes	Collection containing the items
`request`	object	Yes	Item IDs and updated field data

Request object:

1 {
2   "itemIds": ["item-id-1"],
3   "fieldData": {
4     "name": "Updated Title",
5     "post-body": "Updated content..."
6   }
7 }

Returns: Updated items with new field values

Example usage:

Update blog post [item_id] to change the title to "New Title"

You can only update draft items. Published items must be unpublished (set to draft) before updating.

Publish collection items

Publish draft items to make them live on your site.

Action: publish_collection_items

Parameters:

Parameter	Type	Required	Description
`collection_id`	string	Yes	Collection containing the items
`itemIds`	array	Yes	Array of item IDs to publish

Example usage:

Publish blog posts [item-id-1, item-id-2, item-id-3]

Batch publish multiple items at once for efficiency. This is faster than publishing items individually.

Delete collection items

Remove items from a collection permanently.

Action: delete_collection_items

Parameters:

Parameter	Type	Required	Description
`collection_id`	string	Yes	Collection containing the items
`items`	array	Yes	Array of item objects with IDs and optional locale info

Request object:

1 {
2   "items": [
3     {"itemId": "item-id-1"},
4     {"itemId": "item-id-2", "localeId": "es"}
5   ]
6 }

Returns: Confirmation of deletion

Example usage:

Delete blog post [item_id] from collection [collection_id]

Deletion is permanent and cannot be undone. Export or archive important content before deleting.

Best practices

Create as drafts first

Always create items as drafts initially:

Review content before publishing
Make edits without affecting live site
Test with staging environment
Coordinate publishing timing

Set isDraft: true when creating items.

Use batch operations

When working with multiple items:

Create in batches of 10-100 items
Use bulk publish for multiple items
Implement error handling for failed operations
Monitor rate limits

Batching is more efficient than individual operations.

Validate data before creation

Before creating items, ensure:

Required fields are populated
Data types match field types
References point to valid items
Text lengths don’t exceed limits
Dates are in correct format (ISO 8601)

This prevents creation errors.

Handle localization properly

For multi-language sites:

Create items in primary locale first
Add localized versions separately
Specify localeId for each locale
Ensure translated content is complete

Test localized items before publishing.

Limitations

Batch size: Limit bulk operations to 100 items per request
Rate limits: API calls are rate-limited per site
Published items: Cannot update published items directly (must unpublish first)
Deletion: Permanent and cannot be undone
File uploads: Images/files must be uploaded separately via Assets tools