Changelog

The AEO Analytics API (beta) lets you read how AI bots visit your site, and how answer engines mention and cite you. It works with sites that have the AEO analytics entitlement.

Bot traffic

• Get Bot Traffic — total requests from tracked AI bots, 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.

The translatable parameter introduced on July 27 couldn’t express the workflow it was built for, so its shape has changed.

Why it changed

A translation integration reads the primary locale to get the source text, translates it, then writes the result to a secondary locale. As originally shipped, translatable=true resolved exclusion rules against the same localeId used to select the content, which left no way to do that first step correctly:

Site owners can exclude specific fields, properties, or canvas content from AI translation using the Localization panel in the Designer. These endpoints now expose those exclusion rules through a new translatable query parameter. Translation pipeline integrations can fetch exactly the content that should be translated, without tracking exclusion rules themselves.

A minor (maintenance) release to improve how the Webflow MCP works with Claude. Three groups of actions moved out of two large tools into focused tools of their own. The actions themselves are unchanged (same inputs, same behavior).

• Element settings. data_element_settings_tool takes over element settings and data bindings from data_element_tool: reading and writing settings, discovering bindable sources, and setting an element’s tag, visibility, and DOM id (static or bound).

• Component props. data_component_props_tool takes over prop work from data_component_tool: creating, updating, and removing prop definitions, reading an instance’s props, setting prop values, and resetting all props to their defaults.

• Component variants. data_component_variants_tool takes over variant work from data_component_tool: creating, duplicating, deleting, reordering, and renaming variants, and reading or setting per-variant styles.

MCP 2.0 changes what agents can do in Webflow and how. Most element, component, style, and variable operations no longer require a Designer session. This release also adds five new areas of functionality, expands several existing tools, and enforces your workspace’s permissions and audit logging across every agent action. Some tools and actions were renamed or relocated; see Migrating from an earlier version below.

DevLink Export supports a new opt-in camelCaseVariantNames setting in webflow.json that converts Style Variant names into camelCase values for the exported variant prop.

What changed

• New camelCaseVariantNames option under devlink-export in webflow.json. It’s off by default, so existing exports are unaffected.
• When turned on, a Style Variant named Papaya With Whip exports as papayaWithWhip instead of the raw display name. Names that would collide, or that would otherwise produce an invalid value (a number-only name, or a JavaScript reserved word), fall back to safe, deduplicated values.

The base variable mode — the default set of values that variables fall back to — is now first-class in the Designer API. It has the reserved ID "base" and, by default, the name "Base mode".

You can now work with the base mode like any other mode:

• Rename it with mode.setName(). Its ID stays "base" even after it’s renamed.
• Retrieve it by ID with collection.getVariableModeById("base"), or by its (default or renamed) name with collection.getVariableModeByName().