Pages and ComponentsComponents

Update Component Content

This endpoint updates content within a component defintion for secondary locales. It supports updating up to 1000 nodes in a single request.

Before making updates:

  1. Use the get component content endpoint to identify available content nodes and their types
  2. If your component definition has a component instance nested within it, retrieve the nested component instance’s properties that you’ll override using the get component properties endpoint
  3. DOM elements may include a data-w-id attribute. This attribute is used by Webflow to maintain custom attributes across locales. Always include the original data-w-id value in your update requests to ensure consistent behavior across all locales.

This endpoint is specifically for localizing component definitions. Ensure that the specified localeId is a valid secondary locale for the site otherwise the request will fail.

Required scope | components:write

Path parameters

site_idstringRequiredformat: "objectid"
Unique identifier for a Site
component_idstringRequired
Unique identifier for a Component

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

localeIdstringOptional
Unique identifier for a specific locale. Applicable, when using localization.
branchIdstringOptionalformat: "objectid"
Scope the operation to work on a specific branch.

Request

This endpoint expects an object.
nodeslist of objectsRequired
List of DOM Nodes with the new content that will be updated in each node.

Response

Request was successful
errorslist of strings
A list of error messages, if any.

Errors