Changelog

The Optimize API lets you read your optimizations and their results. It works with Webflow sites that have the Optimize add-on, and with non-Webflow sites that use Optimize. See Working with Optimize to get started.

Optimize

• List Optimize IDs: the optimizeId values your token can access, and the resource each one comes from
• List Optimizations: each optimization’s type, status, intervals, and current goals
• Get Optimization Results: each variation’s sessions, users, conversions, and conversion rate for one goal
• Get Audience Insights: the same results, split by the segments of one dimension
• Get Performance Over Time: the same results, by day or week
• List Optimization Goals: an interval’s goals and which are target goals, plus the optimization’s current goals
• List Dimensions: the dimensions you can group or filter reports by
• List Dimension Values: the values seen for a dimension, to use in filters

MCP v2.2 gives agents the data to run an optimization loop. They can read Optimize results to see which variation is winning, track your AEO performance across answer engines and AI crawlers, and use new page-level Analyze reports (scroll depth, window height, page flow, and goals) to understand why. Together, that gives agents what they need to validate the tests you run and improve your AEO scores.

The Analyze API now includes three new reports and two goals endpoints. They require the sites:read scope and a workspace with the Analyze add-on, like the existing Analyze reports.

Analyze

• Scroll depth: the scroll depth (in pixels) that 75%, 50%, and 25% of page views reached.
• Browser window height: average browser window height in CSS pixels over a time window.
• Page flow: pages visitors viewed immediately before or after a selected page, ranked by sessions, users, or page views.
• List goals: the goals configured for your site, including each goal’s type, whether it’s a site goal, and its integration source (HubSpot, Marketo, or Shopify).
• Goal performance: daily unique conversions for one goal, bucketed in the time zone you choose.

The AEO Analytics API lets you read how AI bots visit your site, and how answer engines mention and cite you. AEO, or answer engine optimization, is the practice of improving how your content appears in AI-generated answers. It works with sites that have the AEO analytics entitlement.

Bot traffic

• Get Bot Traffic — total requests from the AI bots Webflow tracks, by provider or category
• Get Bot Traffic by Page — the pages and files bots requested most

The Designer API now includes a Box element preset. Box is a block element with a semantic HTML tag: div, section, header, footer, nav, main, article, aside, address, or figure.

Creating Box elements

Use webflow.elementPresets.Box to create a Box element:

const selectedElement = await webflow.getSelectedElement();
if (selectedElement?.children) {
  const box = await selectedElement.append(webflow.elementPresets.Box);
  if (box.type === 'Block') {

This update lets code component authors detect empty slots and render fallback content. Webflow now reserves prop names that start with __wf_.

Packages:

• @webflow/react 2.7.0
• @webflow/data-types 2.6.0

Check for empty slots

The List Prompt Executions and Get Prompt Execution endpoints no longer return competitorMentions. The field was always an empty array. Remove it from any code or types that expect it. All other fields stay the same.

To see competitor citations, use List Competitor Citations.

The Get Site Plan endpoint now returns the site’s hosting plan consistently. This is a breaking change for any code that compares id or displayName against the previous values.

Starter sites

Sites without a paid hosting plan used to return the Starter workspace plan. They now return the Starter hosting plan.

The new List Workspaces endpoint, GET /v2/workspaces, returns the id, name, and slug of each workspace your token can access. Use it to find the workspace ID that endpoints such as Workspace Members and Create Site require.

The endpoint requires the workspace:read scope and supports workspace API tokens and Data Client apps. The workspace:read scope is now available only to workspace API tokens and Data Client apps. New site API tokens can’t have it.

The Get Authorization Info endpoint only returns the application object for tokens issued to an OAuth app. Tokens without an OAuth app, such as Site and Workspace API tokens (grantType: client_credentials), return authorization only, and the response omits application.

If your code reads application from the response, check that it’s present before using it.

The AEO Analytics API (beta) lets you read how AI bots visit your site, and how answer engines mention and cite you. AEO, or answer engine optimization, is the practice of improving how your content appears in AI-generated answers. It works with sites that have the AEO analytics entitlement.

Bot traffic

• Get Bot Traffic — total requests from the AI bots Webflow tracks, by provider or category
• Get Bot Traffic by Page — the pages and files bots requested most

The Analyze API (beta) now includes three new reports and two goals endpoints.

Analyze

• Scroll depth: the scroll depth (in pixels) that 75%, 50%, and 25% of page views reached.
• Browser window height: average browser window height in CSS pixels over a time window.
• Page flow: pages visitors viewed immediately before or after a selected page, ranked by sessions, users, or page views.
• List goals: the goals configured for your site, including each goal’s type, whether it’s a site goal, and its integration source (HubSpot, Marketo, or Shopify).
• Goal performance: daily unique conversions for one goal, bucketed in the time zone you choose.

The Optimize API (beta) lets you read your optimizations and their results. It works with Webflow sites that have the Optimize add-on, and with non-Webflow sites that use Optimize.

Optimize

• List Optimize IDs — the optimizeId values your token can access, and the resource each one comes from
• List Optimizations — each optimization’s type, status, and intervals
• Get Optimization Results — each variation’s sessions, users, conversions, and conversion rate for one goal
• Get Audience Insights — the same results, split by the segments of one dimension
• Get Performance Over Time — the same results, by day or week
• List Optimization Goals — an interval’s goals, and which one is the target goal
• List Dimensions — the dimensions you can group or filter reports by
• List Dimension Values — the values seen for a dimension, to use in filters

Two new endpoint groups let you manage who has access to a Site or Workspace directly through the API, for Enterprise workspaces.

Site Access

• List Site Members — everyone with access to a Site and the role they hold
• Grant Site Access — add a Workspace Member to a Site, by email or member ID
• Update Site Member Role — change a Member’s Site Role, by member ID or email
• Revoke Site Access — remove a Member’s access to a Site, by member ID or email

v2.9.0 adds workspace folder placement when you import a Cloud app from GitHub, removes the leftover webflow devlink sync command, and fixes what the Server bundle’s manifest lists.

Place an imported app in a workspace folder

webflow apps init --import --new accepts a new --folder-id flag that puts the new standalone app in a workspace folder at creation time:

MCP v2.1 widens what agents can do on the Webflow platform. Three products open to agents for the first time, branch management becomes a complete loop, CMS collections gain field groups and custom-field filtering and sorting, and agents can now generate the instructions that guide their own work. No tool or action names changed, so anything built against v2.0.1 keeps working.

v2.8.0 introduces webflow apps, the new canonical command namespace for managing Webflow Cloud apps. It replaces the piecemeal webflow cloud commands with one consistent surface across the whole app lifecycle, designed so a CI job or an AI agent can drive it end-to-end without scraping human-oriented output: structured --json on read commands, --dry-run previews on every write, and predictable exit codes throughout. Reads also retry transient rate limits (429) automatically with bounded backoff, so a busy CI runner doesn’t need its own retry loop.

The AEO Recommendations API (beta) is now documented for workspaces with the AEO recommendations entitlement.

AEO recommendations

• Get Recommendation Settings — per-rule toggles and recurring audit state
• Update Recommendation Settings — partial update of settings
• List Recommendations — filterable, cursor-paginated list
• Get Recommendations Summary — counts by status and priority
• Get Recommendation — fetch one recommendation by id