This is an overview of the changes to the Webflow APIs and related tools. To filter the list, select one or more tags.
Updated publishing behavior for collection items
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’s 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 thecreateItemAPI is now to create a draft item. All new items will be created with theisDraftflag set totrue. -
Publish CMS Item
Due to changes in how publishing is handled, sites with multiple domains are no longer required to have their domains in sync when publishing a single CMS Item. Previously, users would receive a409error when attempting to publish a CMS item while the domains weren’t in sync. Users will no longer receive a409error when attempting to publish a CMS item.
Page and component content updates
We’ve updated the request body structure for updating content:
-
Update page content
To update a nested Component Instance within a Component, use thepropertyOverridesproperty instead of using thepropertiesproperty. -
Update component content
To update a nested Component Instance within a Component, use thepropertyOverridesproperty instead of using thepropertiesproperty.
301 redirects, workspace management, and CMS publishing improvements
The Data API now supports programmatic management of 301 redirects and workspace administration, alongside enhanced bulk CMS operations in the JavaScript SDK. These additions enable developers to automate site configuration tasks and streamline content management workflows through new endpoints and improved functionality.
For important breaking changes in this release, please see the Breaking Changes update.
New site configuration capabilities
301 redirect management
Take control of your site’s 301 redirects with new endpoints that let you create and manage 301 redirects programmatically:
-
List 301 redirects Get all configured 301 redirects for a site
-
Create 301 redirect Add a new 301 redirection rule
-
Update 301 redirect Modify an existing 301 redirection rule
-
Delete 301 redirect Remove an existing 301 redirection rule
Workspace management
Programmatically create, update, and delete sites within your workspace:
-
Create site Create a new site in your workspace
-
Update site Modify an existing site’s properties
-
Delete site Remove a site from your workspace
Improved CMS operations
Bulk CMS management
The Data API now supports efficient methods to perform operations on multiple CMS items at once:
-
Create multiple items Create single or multiple CMS items in one request
-
Update multiple items Update multiple CMS items simultaneously
-
Update multiple live items Update multiple published CMS items
-
Delete multiple items Unpublish/delete multiple CMS items at once
-
Delete multiple live items Unpublish/delete multiple published CMS items
Enhanced extension management and variable types
In this release, the Designer API introduces key enhancements to improve extension lifecycle management and expand the types of variables available in the Designer.
Extension management
Programmatically close extensions and access contextual launch information
-
webflow.closeExtension()
Close the current extension. This enables more control over the extension lifecycle and user experience flows. -
webflow.getLaunchContext()
Retrieve initialization context information when an extension is launched. This method provides critical data about how the extension was activated, whether through an App Intent, App Connection, or deep link.
Variable system enhancements
Create and manage percentage and number variables for more flexible design systems
-
webflow.createPercentageVariable(options)
Create percentage-based variables for responsive design values such as opacity levels, width/height constraints, or other proportional measurements. -
webflow.createNumberVariable(options)
Create numeric variables for values that require precise control without measurement units, such as animation iterations, z-index values, or quantity indicators.
