Changelog

Programmatic 301 redirects, workspace management, and CMS publishing improvements

Manage 301 redirects Data API v2

New endpoints to manage 301 redirects for your site:

• List 301 Redirects
• Create 301 Redirect
• Update 301 Redirect
• Delete 301 Redirect

Workspace management Data API v2

New endpoints for programmatic site management within workspaces:

• Create Site
• Update Site
• Delete Site

Breaking changes in JavaScript SDK Data API v2

Collection management

Deleting collections and collection fields

• 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()

CMS item creation

Creating CMS items

• CHANGED: client.collections.createItems()
• REMOVED: client.collections.createItemForMultipleLocales()

1
const 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 localization

• CHANGED: The locale query parameter is now localeId

Bulk CMS operations Data API v2

Added methods to create multiple CMS items in a single request:

• client.collections.items.createItems()
  Create a single CMS Item or multiple CMS Items in a Collection
• client.collections.items.updateItems()
  Update multiple CMS Items in a Collection
• client.collections.items.updateItemsLive()
  Update multiple live CMS Items in a Collection
• client.collections.items.deleteItems()
  Unpublish/delete multiple CMS Items in a Collection
• client.collections.items.deleteItemsLive()
  Unpublish/delete multiple live CMS Items in a Collection

SDK fixes Data API v2

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

Updated publishing behavior Data API v2 - beta

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 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 no 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 weren’t in sync. Users will no longer receive a 409 error when attempting to publish a CMS item.

Page and component content updates Data API v2 - beta

We’ve updated the request body structure for updating content:

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

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

Extension management Designer API

• Close extension
  Added a new method to close the extension using the Webflow object.
• Get launch context
  A new method to get the launch context of the extension. This is useful for getting the launch context of the extension when it’s launched from an App Intent, App Connection, or deep link.

New supported variable types Designer API

• Create percentage variable
  A new method to create a percentage variable.
• Create number variable
  A new method to create a number variable.