POST /sites/{site_id}/components/{component_id}/dom
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-idattribute. This attribute is used by Webflow to maintain custom attributes and links across locales. Always include the originaldata-w-idvalue in your update requests to ensure consistent behavior across all locales.
Required scope | components:write
Servers
- https://api.webflow.com/v2
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
site_id |
String | Yes |
Unique identifier for a Site |
component_id |
String | Yes |
Unique identifier for a Component |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
localeId |
String | No |
Unique identifier for a specific Locale. Learn more about localization. |
branchId |
String | No |
Scope the operation to work on a specific branch. |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
nodes[] |
Array | Yes |
List of DOM Nodes with the new content that will be updated in each node. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.