For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Resources
Get started
ReferenceGuidesChangelog
ReferenceGuidesChangelog
  • Token
    • GETGet Authorization User Info
    • GETGet Authorization Info
    • POSTResolve ID Token
  • Sites
    • GETList Sites
    • GETGet Site
    • GETGet Custom Domains
    • POSTPublish Site
  • Pages and Components
      • GETList Components
      • GETGet Component Content
      • POSTUpdate Component Content
      • GETGet Component Properties
      • POSTUpdate Component Properties
  • CMS
  • Forms
  • Custom Code
  • Assets
  • Comments
    • GETSearch Users by Email
    • GETList Comment Threads
    • GETGet Comment Thread
    • GETList Comment Replies
    • POSTCreate Comment Reply
  • Ecommerce
  • Webhooks
  • Site Configuration
  • Enterprise
  • App Subscriptions
    • GETGet app subscriptions
LogoLogo
Resources
Get started
Pages and ComponentsComponents

Update Component Content

POST
https://api.webflow.com/beta/sites/:site_id/components/:component_id/dom
POST
/beta/sites/:site_id/components/:component_id/dom
$curl -X POST "https://api.webflow.com/beta/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"
>        }
>      ]
>    }
>  ]
>}'
1{
2  "errors": []
3}
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`
Was this page helpful?
Previous

Get Component Properties

Next
Built with

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

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.

Learn 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