Get Widget Schema is a WordPress ability from Page Builder: Pagelayer – Drag and Drop website builder — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Get Widget Schema
Read-onlyRetrieve the full set of attributes one Pagelayer widget accepts, compacted to just its own props by default.
Requires the Pagelayer plugin on WordPress 6.9+ (or another source of wp_register_ability()) for the Abilities API — registration is skipped entirely via a function_exists() guard when it isn't available, and ability categories similarly require wp_register_ability_category(). Most abilities require the 'edit_posts' capability; update-global-styles, create-menu, and delete-menu require 'manage_options'. search-images additionally needs a Pexels API key configured on the Pagelayer AI Agents settings page, and get-library-sections/import-library-section call Pagelayer's own hosted library API. Four near-duplicate abilities (get-widget, get-widgets-summary, edit-layout, navigator) are registered in source with mcp_public:false — fully callable over the REST Abilities API but intentionally left out of the advertised MCP tool list as duplicates of get-widget-schema, list-widgets, update-page, and get-page respectively — and are excluded from this listing.
What it does
Given a widget tag, returns that widget's setting sections and properties as compact "type|def:X|opts:a,b|min-maxunit|req:attr=val|resp" strings, one per property, plus a legend explaining the format. By default only the widget's own section props are returned (mode "own"); mode "all" also includes the roughly ten style sections shared by every widget, "shared" or an explicit sections list scopes further, and verbose:true returns the full uncompacted schema (large). This is the primary way an AI client discovers exactly which attribute names and value formats a widget will accept before writing a page node.
See it in action
You ask your AI assistant
"Show me the full attribute schema for the pl_heading widget."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| widget | string | Yes | Widget tag, e.g. "pl_heading". |
| mode | string | No | own (default) | all | shared. |
| sections | array | No | Specific section keys only, e.g. ["ele_bg_styles"]. |
| verbose | boolean | No | Raw uncompacted schema. Very large — avoid. |
Returns
An object with widget (the compact schema: id, name, group, optional must_be_inside/accepts_children/content_attr/unsupported_props, a props map of section to compacted property strings, and a legend), or a WP_Error if the widget tag is unknown.
Permission
Requires the 'edit_posts' capability.
More Page Builder: Pagelayer – Drag and Drop website builder abilities
Add Element
Insert a new element node into a page at a given parent container and index.
Begin Transaction
Snapshot a page's current layout and content as a backup before a multi-step editing sequence.
Change Element Styles
Batch-apply style property changes to page elements matched by ID, pagelayer-id, or widget tag.
Commit Transaction
Discard a page's transaction backup, finalizing the changes made since begin-transaction.
Create / Update Navigation Menu
Create a WordPress nav menu from a list of items (or rebuild an existing one of the same name), optionally with nested Mega Menu content, and assign it to a theme location.
Create Design UI Sections
Append new section nodes onto an existing page without touching what's already there.