Changelog

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

The Branch API (beta) is now documented for Enterprise sites with page branching enabled.

Branches

• Overview — lifecycle, async tasks, conflicts, and entitlement requirements
• List Branches — paginated branch list with computed status and nextActions
• Create Branch — enqueue branch creation from a page
• Get Branch — single branch with status
• Delete Branch — enqueue branch deletion (202 + task poll)
• Get Branch Conflicts — unresolved style and component conflicts
• Update Branch — pull main changes into a branch
• Merge Branch — merge a branch into main
• Publish Branch — publish a branch preview to its staging domain
• Get Branch Task Status — poll async branch tasks

Get page content’s translatable parameter previously only checked whether a page’s entire canvas was excluded from translation. A component instance’s overridden property values were always returned as-is, even when the specific property was excluded — inconsistent with get component properties, which already filtered properties individually.

translatable now filters component property overrides the same way: an overridden value is omitted from a component instance’s propertyOverrides if that property is excluded from translation for the requested locale. If a component instance’s overrides are all excluded, the instance is omitted from the response entirely. A component instance with no overrides at all is unaffected.

v2.5.0 changes where telemetry preferences are stored and fixes a crash affecting sites that combine code components from different sources.

Global telemetry configuration

webflow auth telemetry --enable/--disable now writes to a global config file (~/.config/webflow/telemetry.json on macOS/Linux, %APPDATA%\webflow\telemetry.json on Windows) instead of the current project’s webflow.json. Bare CLI invocations in a project without a manifest no longer create one just to record a telemetry preference.

Get page metadata now accepts translatable, alongside the endpoints that already supported it:

• Get page content
• Get component content and get component properties
• List and get collection items, including their live counterparts

Pass the id of the secondary locale you’re translating into to omit page-level fields (title, slug, SEO title/description, Open Graph title/description) excluded from translation for that locale — they’re left out of the response entirely rather than returned as null. Behavior matches the other endpoints: the value must be a secondary locale id (400 otherwise), and the request returns a 403 if translation exclusions aren’t enabled for the site.