update_widget_settings
Destructive
Merge partial settings into an Elementor widget with automatic backup, validation, and post-write verification to ensure changes persist.
Instructions
Shallow-merge a partial settings object into one widget. Backs up the page first, validates the result, auto-flushes CSS, then re-reads the page and verifies the patch persisted (matches_requested in the response). Two-call confirmation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"page_id": "<page_id>",
"widget_id": "<widget_id>",
"settings_patch": "<settings_patch>"
},
"name": "update_widget_settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site_id | No | ||
| page_id | Yes | ||
| widget_id | Yes | ||
| settings_patch | Yes | ||
| confirmation | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| page_id | Yes | ||
| confirmation_token | No | ||
| backup_meta_key | No | ||
| css_flush | No | ||
| mutated | No | ||
| warnings | No | ||
| verification | No | ||
| widget_id | Yes | ||
| keys_changed | Yes |