Components

Manage Webflow components, update component content, and configure component properties using the Components tools. Components are reusable design elements that can be instantiated across multiple pages.


List components

List all components in a site. Returns component metadata including IDs, names, and versions.

Tool: components_list

site_id
stringRequired

Unique identifier for the site

limit
number

Maximum number of records to return (max: 100)

offset
number

Offset for pagination

Returns

Response
1{
2 "components": [
3 {
4 "id": "6596da6045e56dee495bcbba",
5 "name": "Primary Button",
6 "group": "Buttons",
7 "description": "A default button component that can be used across the site"
8 },
9 {
10 "id": "658205daa3e8206a523b5ad4",
11 "name": "Secondary Button",
12 "group": "Buttons",
13 "description": "A secondary button component that can be used across the site"
14 },
15 {
16 "id": "6258612d1ee792848f805dcf",
17 "name": "Card",
18 "group": {},
19 "description": {}
20 },
21 {
22 "id": "68a2b1d1ee792848f805dcf",
23 "name": "Nav",
24 "group": {},
25 "description": {},
26 "readonly": true
27 }
28 ],
29 "pagination": {
30 "limit": 20,
31 "offset": 0,
32 "total": 4
33 }
34}

Get component content

Get the content structure and data for a specific component including text, images, and nested components.

Tool: components_get_content

site_id
stringRequired

Unique identifier for the site

component_id
stringRequired

Unique identifier for the component

localeId
string

Unique identifier for a specific locale (for localized sites)

limit
number

Maximum number of records to return (max: 100)

offset
number

Offset for pagination

Returns

Response
1{
2 "componentId": "69118560-d0bc-15fc-bbf8-b8fe5f6535b5",
3 "nodes": [
4 {
5 "id": "a245c12d-995b-55ee-5ec7-aa36a6cad623",
6 "type": "text",
7 "text": {
8 "html": "<h1>The Hitchhiker's Guide to the Galaxy</h1>",
9 "text": "The Hitchhiker's Guide to the Galaxy"
10 },
11 "attributes": {}
12 },
13 {
14 "id": "a245c12d-995b-55ee-5ec7-aa36a6cad627",
15 "type": "text",
16 "text": {
17 "html": "<div><h3>Don't Panic!</h3><p>Always know where your towel is.</p></div>",
18 "text": "string"
19 },
20 "attributes": {
21 "number": "forty two"
22 }
23 },
24 {
25 "id": "a245c12d-995b-55ee-5ec7-aa36a6cad629",
26 "type": "image",
27 "image": {
28 "alt": "Marvin, the Paranoid Android",
29 "assetId": "659595234426a9fcbad57043"
30 },
31 "attributes": {}
32 },
33 {
34 "id": "6e468d51-8942-f7be-34cc-347b0e24e118",
35 "type": "text-input",
36 "placeholder": "Search…",
37 "attributes": {}
38 },
39 {
40 "id": "82cdcd0b-b9c7-0ddc-0519-bc1fa02de26e",
41 "type": "select",
42 "choices": [
43 {
44 "value": "Magrathea",
45 "text": "Magrathea"
46 },
47 {
48 "value": "mostly-harmless",
49 "text": "Earth"
50 },
51 {
52 "value": "Vogsphere",
53 "text": "Vogsphere"
54 }
55 ],
56 "attributes": {}
57 },
58 {
59 "id": "9fa3a9c4-87d4-19b0-95f7-1b0b099f82ab",
60 "type": "submit-button",
61 "value": "Subscribe",
62 "waitingText": "Please wait...",
63 "attributes": {}
64 },
65 {
66 "id": "a245c12d-995b-55ee-5ec7-aa36a6cad631",
67 "type": "text",
68 "text": {
69 "html": "string",
70 "text": "string"
71 },
72 "componentId": "6258612d1ee792848f805dcf",
73 "propertyOverrides": [
74 {
75 "propertyId": "a245c12d-995b-55ee-5ec7-aa36a6cad633",
76 "type": "Plain Text",
77 "text": {
78 "html": null,
79 "text": "Don't Panic!"
80 }
81 },
82 {
83 "propertyId": "a245c12d-995b-55ee-5ec7-aa36a6cad635",
84 "type": "Rich Text",
85 "text": {
86 "html": "<div><p>Always know where your towel is.</p></div>",
87 "text": null
88 }
89 }
90 ]
91 }
92 ],
93 "pagination": {
94 "limit": 7,
95 "offset": 0,
96 "total": 7
97 }
98}

Update component content

Update content on a component in secondary locales by modifying text nodes and property overrides.

Tool: components_update_content

This tool is only for updating content in secondary locales. The localeId parameter is required, and requests to update primary locale content will fail.

site_id
stringRequired

Unique identifier for the site

component_id
stringRequired

Unique identifier for the component

localeId
stringRequired

Unique identifier for the target locale

nodes
arrayRequired

Array of node updates with text content and property overrides

Returns: Updated component content confirmation


Get component properties

Get component properties including default values and configuration for a specific component.

Tool: components_get_properties

site_id
stringRequired

Unique identifier for the site

component_id
stringRequired

Unique identifier for the component

localeId
string

Unique identifier for a specific locale

limit
number

Maximum number of records to return (max: 100)

offset
number

Offset for pagination

Returns

Response
1{
2 "componentId": "658205daa3e8206a523b5ad4",
3 "properties": [
4 {
5 "propertyId": "a245c12d-995b-55ee-5ec7-aa36a6cad623",
6 "type": "Plain Text",
7 "label": "Title",
8 "text": {
9 "html": "string",
10 "text": "The Hitchhiker's Guide to the Galaxy"
11 }
12 },
13 {
14 "propertyId": "a245c12d-995b-55ee-5ec7-aa36a6cad627",
15 "type": "Rich Text",
16 "label": "Content",
17 "text": {
18 "html": "<div><h3>Don't Panic!</h3><p>Always know where your towel is.</p></div>",
19 "text": "string"
20 }
21 }
22 ],
23 "pagination": {
24 "limit": 2,
25 "offset": 0,
26 "total": 2
27 }
28}

Update component properties

Update component properties for localization to customize behavior in different languages.

Tool: components_update_properties

site_id
stringRequired

Unique identifier for the site

component_id
stringRequired

Unique identifier for the component

localeId
stringRequired

Unique identifier for the target locale

properties
objectRequired

Object with property updates

Returns: Updated component properties confirmation