Changelog

April 8, 2025
MCP Hero Image

Introducing Webflow’s MCP server

For developers using AI-powered tools like Cursor or Claude Desktop, we provide a Model Context Protocol (MCP) server that enhances the agent’s understanding of your Webflow projects. The MCP server has tools that enable the AI agent to access real-time information about your sites, collections, and other objects, enabling more accurate and contextual code suggestions and troubleshooting. To see a full list of tools, see the MCP server documentation.

LLMS.txt support

We’re excited to announce compatibility with the emerging /llms.txt standard, making your documentation accessible and optimized for AI developer tools such as Cursor, GitHub Copilot, ChatGPT, Perplexity, and Anthropic’s Claude.

/llms.txt is designed to be token-efficient, ensuring faster processing and cost-effective LLM interactions without sacrificing valuable info. Learn more

  • Use https://developers.webflow.com/llms.txt to access the LLM-readable documentation.
  • Additionally, you can access markdown versions of any documentation page to provide a more structured and context-rich experience for LLMs. To access the markdown version of a page, add .md to the end of the URL.
April 8, 2025

Data API v2

Introducing new comments APIs

We’re excited to introduce a new Comments API. With these endpoints, you can programmatically access comments across your Webflow sites, enabling new integrations with your existing tools and workflows. This release makes it easier than ever to track feedback, coordinate reviews, and streamline your content management processes.

Timing on comments

There may be up to a 5-minute delay before comment threads appear in the system. This delay may also occur in webhook notifications.

Additional support for site configuration with .well-known files

In addition to our existing support for site configuration, we’ve added new endpoints to set and delete .well-known files. This empowers site managers to automate and streamline the management of site metadata and security configurations, enhancing integration with modern web protocols and improving overall site interoperability. For more information, see Wefblow’s help documentation on .well-known files.

Designer API

Control form settings and fields from the Designer API

We’ve added new methods to manage form settings using the Designer API. This means you can now create forms using the element creation methods and using the FormForm element preset. Once the form is created, or if you already have a form created, you can use the new methods to manage the following settings - and manage required fields on forms:

  • Name: the name of the form
  • Redirect URL: the URL to redirect to after the form is submitted
  • Action: the URL to send the form data to
  • Method: the HTTP method to use when sending the form data

Form Settings

Form Fields

Additionally, you can manage required fields on forms.

March 12, 2025

03.12.2025

Data API v2

Data API BETA

  • Comments API
    Webflow’s API now supports operations to retrieve comments on a site with these new endpoints:

    Note: Comment replies are not included in the initial thread listing. To retrieve replies, first get the Comment Thread ID from the list endpoint, then use that ID with the replies endpoint.

  • Retrieve and update additional component node types
    In addition to Text and Nested Component Instances, you can now update the following node types:

    • text-input - Update placeholder text on a text input node
    • select - Update choices on a select node
    • submit-button - Update text and waiting message on a submit button node
    • search-input - Update text on a search button node

Designer API

Support for Form Elements

Webflow’s Designer API now supports the following methods for Form elements:

Support for Variable Modes

February 28, 2025

02.28.25

Data API v2

Added

  • List Form Submissions by Site
    Added a new endpoint to list form submissions for a given site. This endpoint differs from the existing List Form Submissions endpoint by accepting siteId as a path parameter and elementId as a query parameter. Use this endpoint to get a consolidated list of form submissions for a form that appears across multiple component instances.

Designer API

Added

Updated

February 5, 2025

02.06.25

Data API v2

Data API v2 BETA

  • Support for additional well-known files.
    The API now supports uploading well-known files with the following requirements:
    • File size must be less than 100KB per file
    • Maximum of 30 files total
    • Files must have one of these extensions (or no extension):
      • .txt
      • .json
      • .noext - A special extension that removes other extensions when uploaded. This helps compatibility with tools that require file extensions
        Example: apple-app-site-association.noext.txt will be uploaded as apple-app-site-association
  • Create Option fields
    Option fields are a type of collection field that allows you to create a list of options. You can create an option field during collection creation using the create collection endpoint or by updating an existing collection using the create collection field endpoint.

Designer API

January 16, 2025

01.16.25

Data API v2

  • Delete form submission endpoint.
    This endpoint allows you to delete a form submission from a site.
  • Added the lastPublished parameter to the customDomains object.
    This parameter returns the date and time of the last published version of a site’s custom domain. This parameter will appear in the response for the get custom domains endpoint, as well as the list sites and get site endpoints.

JavaScript SDK — Data API v2

  • Version 3.1.0 is now available and up to date with the latest changes in the Data API v2.

Data API BETA

  • Create reference fields in a collection.
    To create a reference field, choose MultiReference or Reference as the type property in the field object. Additionally, include the metadata property to specify the collectionId of the collection that the reference field will point to. You can create a reference field during collection creation using the create collection endpoint or by updating an existing collection using the create collection field endpoint.
  • Create collection fields during collection creation.
    You can now create multiple collection fields during collection creation using the create collection endpoint. Collections are limited to 60 fields per collection.

Designer API

December 17, 2024

12.17.24

New Endpoints

Site Redirects A new set of endpoints to manage redirects for a site.

Workspace Management A new set of endpoints to manage sites within a workspace.

  • Create Site
    A new endpoint to create a site for a workspace.
  • Update Site
    A new endpoint to update a site for a workspace.
  • Delete Site
    A new endpoint to delete a site for a workspace.
Updated publishing behavior

Starting December 2024, Webflow is introducing an improved publishing workflow for collection items. When a live item’s isDraft property is set to true, the item will continue to remain published on the live site even after a full site publish. This allows users to make updates to the collection item in a draft state without changing what is visible on the live site.

To remove an item from the live site, you must now explicitly call the unpublish endpoint. This change gives developers more precise control over the publishing state of individual items. Please see the “publishing items” section of the CMS guide for more details.

  • Create CMS Item
    The default behavior of the createItem API is now to create a draft item. All new items will be created with the isDraft flag set to true.
  • Publish CMS Item
    Due to changes in how publishing is handled, sites with multiple domains are longer required to have their domains in sync when publishing a single CMS Item. Previously, users would receive a 409 error when attempting to publish a CMS item while the domains were not in sync. Users will no longer receive a 409 error when attempting to publish a CMS item.

CMS APIs

  • Update page content
    Updated properties in the request body. To update a nested Component Instance within a Component, use the propertyOverrides property instead of using the properties property, .
  • Update component content
    Updated properties in the request body. To update a nested Component Instance within a Component, use the propertyOverrides property instead of using the properties property, .

Breaking Changes

CMS APIs

Deleting collections and collection fields
Deleting a Collection is now achieved through client.collections.delete(), which was previously an API used to delete a Collection field. The method client.collections.deleteCollection() has been removed.

  • CHANGED: To delete a Collection, use: client.collections.delete(collectionId)
  • NEW: To delete a Collection field, use: client.collections.deleteField(collectionId, fieldId)
  • REMOVED: client.collections.deleteCollection()

Creating CMS items
Creating multiple CMS items across multiple locales is now achieved through client.collections.createItems(), which was previously achieved through client.collections.createItemForMultipleLocales().

  • CHANGED: client.collections.createItems()
  • REMOVED: client.collections.createItemForMultipleLocales()
1const newItems = client.collections.items.createItems(collectionId, {
2    cmsLocaleIds: [primaryCmsLocaleId, secondaryCmsLocaleId],
3    isArchived: false,
4    isDraft: false,
5    fieldData: {
6        name: "My Item For Multiple Locales",
7        slug: "my-item",
8        "plain-text": "foo",
9    },
10});

Pages APIs

  • Localization
    The locale query parameter is now localeId.
    • CHANGED: locale -> localeId

New features

Fixes

  • Some APIs that created resources (i.e. collections.items.createItem()) had request payload types that required an id, which is not possible to provide. This is no longer required.
  • fieldData type in CMS Items now allows arbitrary extra key/value pairs - allowing the creation of CMS Items with custom fields.

New methods

November 21, 2024

11.21.24

Changelog: November 21, 2024

Discover the latest updates to the Webflow Data API, including enhancements for bulk CMS authoring, new locale parameter conventions, and beta API improvements.

Data API v2

Updated Endpoints

Improvements to Bulk CMS Authoring via Create Collection Item(s)
You can now create multiple CMS items using the original POST endpoint for creating collection items. By including the items property in your request, you can pass either a single item object or an array of objects. This functionality complements the bulk Create Items endpoint, offering more flexibility for CMS authoring.

Introducing the localeId Parameter
To align with our updated query parameter naming conventions, we’re introducing the localeId parameter as a replacement for locale. While locale is still supported for compatibility, localeId is now the preferred parameter. The following endpoints are affected:

Data API BETA

New Endpoints

List Form Submissions by Site
This endpoint differs from the existing List Form Submissions endpoint by accepting siteId as a path parameter and elementId as a query parameter. Use this parameter to filter submissions on a site by the formElementId. This is particularly helpful for forms included in components, which are given a different formId for each component instance, while still keeping the same formElementId across instances. The formElementId is an attribute from each form object in the List Forms API. Using this endpoint, you can pass the siteId and the formElementId to get all form submissions for a single form that appears in multiple component instances.

Updated Endpoints

Introducing the localeId Parameter
To align with our updated query parameter naming conventions, we’re introducing the localeId parameter as a replacement for locale. While locale is still supported for compatibility, localeId is now the preferred parameter. The following endpoints are affected:

For additional details, visit our Data API documentation.

October 23, 2024

10.23.24

We’re thrilled to introduce powerful new features to the Data API. We’ve added bulk CMS item authoring, editing, and deleting, supporting up to 100 items per request. These endpoints can help manage previous rate limit issues and makes managing large content sets more efficient.

Data API v2

Updated Endpoints

  • Create Collection Items Create a single item or multiple items in a Collection. This endpoint supports creating items across multiple locales and can update up to 100 items in a request.

🆕 New Endpoints

Bulk Staged Items

  • Update Collection Items
    Update a single item or multiple items in a Collection. This endpoint can update up to 100 items in a request.
  • Delete Collection Items
    Delete Items from a Collection. This endpoint can delete up to 100 items in a request.

Bulk Live Items

  • Update Live Collection Items
    Update a single live item or multiple live items in a Collection. This endpoint can update up to 100 items in a request.
  • Delete Live Collection Items
    Remove an item or multiple items from the live site. Deleting published items will un-publish the items from the live site and set them to draft. This endpoint can delete up to 100 items in a request.
October 1, 2024

10.01.24

We’re thrilled to introduce powerful new features across both the Data API and Designer Extensions. We’ve added bulk CMS item authoring, editing, and deleting, supporting up to 100 items per request. These endpoints can help manage previous rate limit issues and makes managing large content sets more efficient. We’ve also introduced deep linking to Hybrid Apps, allowing seamless transitions into the Designer with your App automatically launched.

Data API BETA

🆕 New Endpoints

  • Update Collection Items
    Update a single item or multiple items in a Collection. This endpoint can update up to 100 items in a request.
  • Delete Collection Items
    Delete Items from a Collection. This endpoint can delete up to 100 items in a request.
  • Update Live Collection Items
    Update a single live item or multiple live items in a Collection. This endpoint can update up to 100 items in a request.
  • Delete Live Collection Items
    Remove an item or multiple items from the live site. Deleting published items will un-publish the items from the live site and set them to draft. This endpoint can delete up to 100 items in a request.
  • Update Localized Component Properties
    Update the properties of a component definition in a specified locale.

Updated Endpoints

  • Create Collection Items
    Create a single item or multiple items in a Collection. This endpoint can update up to 100 items in a request.
    Note: This endpoint was previously used to create a single Collection Item for multiple locales. The endpoint can now handle requests for multiple items in multiple locales.

Updated Payloads

  • Form Submission
    Added schema and formElementId properties to the Form Submission webhook payload for better form visibility

Designer API

🆕 New Feature

  • Seamless Integration with Deep Links in Hybrid Apps
    Enhance the transition between third-party experiences and your Designer Extension by utilizing deep links. With deep links, users are directed straight to their site in the Designer with your app automatically launched, ensuring a smooth, uninterrupted workflow. You can construct a deep-link with the following format:
    <site short name>.design.webflow.com?app=<client id>

Older posts
Built with