Update Component Content

POST

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

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_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 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

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       "propertyOverrides": [
17         {
18           "propertyId": "7dd14c08-2e96-8d3d-2b19-b5c03642a0f0",
19           "text": "<div><h1>Time is an <em>illusion</em></h1></div>"
20         },
21         {
22           "propertyId": "7dd14c08-2e96-8d3d-2b19-b5c03642a0f1",
23           "text": "Life, the Universe and Everything"
24         }
25       ]
26     }
27   ]
28 }'

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	"propertyOverrides": [
17	{
18	"propertyId": "7dd14c08-2e96-8d3d-2b19-b5c03642a0f0",
19	"text": "<div><h1>Time is an <em>illusion</em></h1></div>"
20	},
21	{
22	"propertyId": "7dd14c08-2e96-8d3d-2b19-b5c03642a0f1",
23	"text": "Life, the Universe and Everything"
24	}
25	]
26	}
27	]
28	}'