Update Component Content

POST

This endpoint allows you to update content within a component in a secondary locale.

It is designed specifically for localized components and can handle up to 1000 nodes per request. To get started, use the Get Component Content endpoint to identify content nodes and types available for the component.

If you’re updating a component’s properties, be sure to retrieve them via the Get Component Properties endpoint.

This endpoint is specifically for localized components. Ensure that the specified locale is a valid secondary locale for the site.

Required scope | components:write

Path parameters

site_idstringRequired

Unique identifier for a Site

component_idstringRequired

Unique identifier for a Component

Query parameters

localeIdstringOptional

Unique identifier for a specific locale. Applicable, when using localization.

Request

This endpoint expects an object.

nodeslist of objectsRequired

List of nodes within components OR a nested component instance’s properties to update (with their corresponding new values).

Response

Request was successful

errorslist of strings

A list of error messages, if any.

Errors

POST

1 curl -X POST "https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/components/8505ba55-ef72-629e-f85c-33e4b703d48b/dom?localeId=65427cf400e02b306eaa04a0" \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "nodes": [
6     {
7       "nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad623",
8       "text": "<h1>The Hitchhiker’s Guide to the Galaxy</h1>"
9     },
10     {
11       "nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad627",
12       "text": "<div><h3>Don’t Panic!</h3><p>Always know where your towel is.</p></div>"
13     },
14     {
15       "nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad629",
16       "text": "<img alt=\"Marvin, the Paranoid Android\" src=\"path/to/image/with/assetId/659595234426a9fcbad57043\"/>"
17     }
18   ]
19 }'

1 {
2   "errors": [
3     "errors"
4   ]
5 }

Get Component Properties

Up Next

Built with

1	curl -X POST "https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/components/8505ba55-ef72-629e-f85c-33e4b703d48b/dom?localeId=65427cf400e02b306eaa04a0" \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"nodes": [
6	{
7	"nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad623",
8	"text": "<h1>The Hitchhiker’s Guide to the Galaxy</h1>"
9	},
10	{
11	"nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad627",
12	"text": "<div><h3>Don’t Panic!</h3><p>Always know where your towel is.</p></div>"
13	},
14	{
15	"nodeId": "a245c12d-995b-55ee-5ec7-aa36a6cad629",
16	"text": "<img alt=\"Marvin, the Paranoid Android\" src=\"path/to/image/with/assetId/659595234426a9fcbad57043\"/>"
17	}
18	]
19	}'