POST /sites/{site_id}/components/{component_id}/properties
Update the default property values of a component definition in a specificed locale.
Before making updates:
- Use the get component properties endpoint to identify properties that can be updated in a secondary locale.
- Rich Text properties may include a
data-w-idattribute. This attribute is used by Webflow to maintain links across locales. Always include the originaldata-w-idvalue in your update requests to ensure consistent behavior across all locales.
The request requires a secondary locale ID. If a localeId is missing, the request will not be processed and will result in an error.
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 |
|---|---|---|---|
properties[] |
Array | Yes |
A list of component properties to update within the specified secondary locale. |
properties[].text |
String | Yes |
The new string or HTML value used to update the component property in the secondary locale. The provided value must be compatible with the type of the component property. For example, attempting to update a single-line plain-text property with a multi-line value will result in an error. |
properties[].propertyId |
String | Yes |
The ID of the property. |
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.