page_element
Search, inspect, update, or batch-edit elements in a saved storefront page, or append a new section, with optional dry-run previews before applying changes.
Instructions
Read and edit single elements on a saved page, or append a section. Pick the operation with action and pass that action's arguments (help:true returns its full documentation and schema).
search_page_elements: Search/filter elements within a page source.
get_page_element: Get full detail of a single element by its ID (e.g.
update_page_element: Update properties of a specific element in page source.
update_page_elements: Batch update multiple elements in one page.
add_section: Append a section to an EXISTING page's source.
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": {
"action": "<action>"
},
"name": "page_element"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Filter by element ID substring (e.g. [search_page_elements] | |
| help | No | Return the action's full documentation and argument schema instead of running it | |
| text | No | Filter by text content substring [search_page_elements] | |
| type | No | Filter by element type (e.g. [search_page_elements] | |
| limit | No | Max results (default 50) [search_page_elements] | |
| style | No | Style to merge, camelCase like the editor (e.g. [update_page_element] | |
| action | Yes | Which operation to run | |
| config | No | Config to merge (layout: widthUnit auto|px|%, constraintX/Y, columnStart…). [update_page_element] | |
| events | No | Complete events array (replaces existing) [update_page_element] | |
| dry_run | No | Preview only (true) or apply changes (false). [update_page_element, update_page_elements, add_section] | |
| page_id | No | Page ID | |
| section | No | A section node (from new_section) — object or JSON string [add_section] | |
| updates | No | Array of element updates [update_page_elements] | |
| bindings | No | Complete bindings array (replaces existing) [update_page_element] | |
| has_bind | No | Only elements with data bindings (product, category, blog) [search_page_elements] | |
| specials | No | Specials to merge (text, custom_class, custom_css, etc.) [update_page_element] | |
| template | No | Insert a library section instead (ids from list_section_templates) [add_section] | |
| element_id | No | Element ID (e.g. [get_page_element, update_page_element] | |
| has_events | No | Only elements with events (click, submit, mouseenter, etc.) [search_page_elements] | |
| responsive | No | Responsive breakpoint overrides (e.g. [update_page_element] | |
| allow_shrink | No | Allow the source to shrink by more than half: set it when native elements replaced an oversized e… [update_page_element, update_page_elements] | |
| custom_class | No | Filter by custom class substring [search_page_elements] | |
| has_custom_class | No | Only elements that have a custom class [search_page_elements] |