Changelog

This is an overview of the changes to the Webflow APIs and related tools. To filter the list, select one or more tags.

June 18, 2024

CMS item filtering and sorting

The Webflow Data API now supports server-side filtering and sorting capabilities for CMS items, along with enhanced page metadata information. These updates help you optimize data retrieval, improve performance, and gain access to additional page details.

Enhanced CMS item management

The CMS endpoints List CMS items and List live CMS items now feature filtering and sorting capabilities to help you optimize data retrieval and build more efficient applications.

Server-side filtering options

You can now filter CMS items with these new parameters:

  • Name and slug exact matching Use name and slug query parameters for precise filtering

    GET /collections/{collection_id}/items?name=Featured+Article
    GET /collections/{collection_id}/items?slug=featured-article

  • Publication date ranges Filter by lastPublished date ranges to find recently updated content

    GET /collections/{collection_id}/items?lastPublished[gt]=2024-05-01T00:00:00Z
    GET /collections/{collection_id}/items?lastPublished[lt]=2024-06-18T00:00:00Z

  • Combined filters Combine multiple filters for precise data retrieval

    GET /collections/{collection_id}/items?slug=featured-article&lastPublished[gt]=2024-05-01T00:00:00Z

Server-side sorting

Sort your CMS items directly on the server to minimize data processing in your application:

  • Sort by publication date Sort by lastPublished in ascending or descending order

    GET /collections/{collection_id}/items?sortBy=lastPublished&sortOrder=asc
    GET /collections/{collection_id}/items?sortBy=lastPublished&sortOrder=desc

  • Sort by name or slug Sort alphabetically by item name or slug

    GET /collections/{collection_id}/items?sortBy=name&sortOrder=asc
    GET /collections/{collection_id}/items?sortBy=slug&sortOrder=asc

Server-side filtering and sorting significantly reduce the amount of data transferred and processed by your application, improving performance and reducing API usage.

Enhanced page metadata

The Get page metadata endpoint now includes additional information that’s valuable for multi-language sites and SEO optimization.

New metadata fields

  • localeId Identify the language/locale of a specific page

  • publishedPath Access the published URL path for the page

June 18, 2024

New methods for asset management, image element handling, and page type identification

This release introduces new capabilities for asset management, image element manipulation, and page type identification in the Designer API.

Feature highlights

  • Enhanced asset management - New methods to retrieve and work with assets throughout your site
  • Image element manipulation - Programmatically control image elements, including setting assets and alt text
  • Page type identification - Determine the category of any page in your Webflow project

New endpoints

Image element methods

  • element.getAsset()
    Retrieve the asset currently assigned to an Image element, enabling dynamic content management.

  • element.setAsset(asset)
    Assign an asset to an Image element programmatically, perfect for automated content updates.

  • element.getAltText()
    Retrieve the accessibility alt text for an Image element on the canvas.

  • element.setAltText(altText)
    Set the accessibility alt text for an Image element, improving the site’s accessibility.

Asset management methods

  • webflow.getAllAssets()
    Retrieve all assets available on a site, providing a complete inventory for management and selection.

  • asset.getName()
    Get the name of a specific asset, useful for identification and organization.

  • asset.getMimeType()
    Retrieve the MIME type of an asset, allowing for proper handling based on file type.

  • asset.getAltText()
    Get the accessibility alt text associated with a specific asset.

  • asset.setAltText(altText)
    Set the accessibility alt text for a specific asset, ensuring it’s available whenever the asset is used.

Page identification

  • page.getKind()
    Determine the type of a Webflow page. Returns one of: static, ecommerce, cms, userSystems, utility, or staticTemplate.