Update Component Content | Webflow Developer Documentation

curl -X POST "https://api.webflow.com/v2/sites/580e63e98c9a982ac9b8b741/components/8505ba55-ef72-629e-f85c-33e4b703d48b/dom?localeId=65427cf400e02b306eaa04a0&branchId=68026fa68ef6dc744c75b833" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "nodes": [
    {
      "nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad623",
      "text": "<h1>The Hitchhiker\'s Guide to the Galaxy</h1>"
    },
    {
      "nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad627",
      "text": "<div><h3>Don\'t Panic!</h3><p>Always know where your towel is.</p></div>"
    },
    {
      "nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad635",
      "text": "<h1>Hello world</h1>",
      "choices": [
        {
          "value": "choice-1",
          "text": "First choice"
        },
        {
          "value": "choice-2",
          "text": "Second choice"
        }
      ]
    },
    {
      "nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad642",
      "text": "<h1>Hello world</h1>",
      "placeholder": "Enter something here..."
    },
    {
      "nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad671",
      "text": "<h1>Hello world</h1>",
      "value": "Submit",
      "waitingText": "Submitting..."
    },
    {
      "nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad629",
      "text": "<h1>Hello world</h1>",
      "propertyOverrides": [
        {
          "propertyId": "7dd14c08-2e96-8d3d-2b19-b5c03642a0f0",
          "text": "<div><h1>Time is an <em>illusion</em></h1></div>"
        },
        {
          "propertyId": "7dd14c08-2e96-8d3d-2b19-b5c03642a0f1",
          "text": "Life, the Universe and Everything"
        }
      ]
    }
  ]
}'

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:

Use the get component content endpoint to identify available content nodes and their types.
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.
DOM elements may include a data-w-id attribute. This attribute is used by Webflow to maintain custom attributes and links 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

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](/data/reference/pages-and-components/components/get-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](/data/reference/pages-and-components/components/get-properties) endpoint. 3. DOM elements may include a `data-w-id` attribute. This attribute is used by Webflow to maintain custom attributes and links across locales. Always include the original `data-w-id` value in your update requests to ensure consistent behavior across all locales. <Note> 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. </Note> Required scope | `components:write`

Authentication

AuthorizationBearer

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

Path parameters

site_idstringRequiredformat: "objectid"

Unique identifier for a Site

component_idstringRequired

Unique identifier for a Component

Query parameters

localeIdstringOptional

Unique identifier for a specific Locale.

Lear more about localization.

branchIdstringOptionalformat: "objectid"

Scope the operation to work on a specific branch.

Request

The body for which to update the Component DOM nodes. Nodes can be of type text, select or text input, submit button, or component instances.

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

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

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:

Use the get component content endpoint to identify available content nodes and their types.
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.
DOM elements may include a data-w-id attribute. This attribute is used by Webflow to maintain custom attributes and links 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

1	{
2	"errors": []
3	}