AI Abilities is a Premium Addons for Elementor feature that connects AI clients such as Claude, Cursor, and Codex to your WordPress site through a built-in MCP server. Each ability is one action the connected AI can perform on your site. This doc covers one of the Build abilities: Insert Widget.
Insert Widget lets your AI client place any registered Elementor widget on a page, post, or template, with its settings already filled in. This is the ability that puts actual content on your pages: headings, buttons, and any of the Premium Addons widgets, like the Carousel or Lottie Animations.
The AI typically pairs it with two Discovery abilities. It calls premium-addons/get-widget-schema first to learn the widget’s exact setting keys, then inserts the widget with the values it wants, into whatever container premium-addons/get-page-structure shows as the right spot.
At a Glance
| Category | Build |
| Access | Write |
| Destructive | No |
| MCP tool name | premium-addons/insert-widget |
| Available since | Premium Addons v4.11.85 |
Before You Start
This ability is part of the AI Abilities feature. If you have not set it up yet, follow the Elementor AI Abilities (MCP Tools) Tutorial first to enable the feature and connect your AI client. The ability must also be switched on under Premium Addons → AI Abilities & MCP Config, in the Build category:
Use Cases
Fill a page with Premium Addons widgets. Ask your AI client to “Build a summer sale popup that appears on page exit intent, using Premium Addons widgets, and use the Display Conditions addon to hide it on touch devices.” The AI inserts each widget with its settings already configured, so nothing lands on the page with defaults you then have to fix.
Add one configured widget, fast. Prompt “Add a Premium Countdown timer to my Offer page, ending July 31 at midnight, with the digits in #d97706.” The AI looks up the widget’s schema, inserts it in the right container, and sets the date and colors in one call.
Rebuild a section with richer elements. Ask to “Replace the plain image gallery on my portfolio page with the Premium Grid widget, keeping my images and adding a hover effect.” The AI reads the current settings, removes the old widget, and inserts the Grid configured to match.
Good to Know
- The widget must be registered on your site. A Premium Addons widget you disabled in the dashboard is not registered, and the ability says so instead of failing silently.
- Premium Addons free covers Elementor and Premium Addons widgets. Inserting a widget from a third-party plugin requires Premium Addons Pro.
- Elementor v4 atomic widgets are not supported yet; the ability rejects them cleanly rather than saving broken settings.
- Setting keys the widget does not have are left out of the saved settings and reported back in
unknown_keys, so the AI learns it guessed a key wrong instead of wondering why a value did nothing. - Group prerequisite toggles are handled for you. Pass a background color without the background type toggle, for example, and the ability switches the toggle on and reports it in
auto_set. Without that, Elementor would store the color but render nothing. - Repeater settings (like carousel slides or price list rows) take an array of row objects.
Inputs
| Parameter | Required | Description |
|---|---|---|
post_id | Yes | The page, post, or template to insert the widget into. |
widget_type | Yes | The widget to insert, by its type name (for example premium-carousel, heading, button). |
settings | No | The widget’s settings, using its native setting keys. The AI gets the exact keys from premium-addons/get-widget-schema. |
parent_id | No | The container to place the widget in. Omitted, the widget lands at the top level of the page. |
position | No | Where among the container’s children to insert it, counting from 0. Omitted, it goes last. |
Output
| Field | Description |
|---|---|
element_id | The ID of the new widget on the page. |
post_id | The document the widget was inserted into. |
widget_type | The widget type that was inserted. |
unknown_keys | Setting keys that are not real controls on this widget and were left out. |
auto_set | The prerequisite toggles the ability switched on to make the passed values take effect. |
Come & Join the Community
Feel free to join our Facebook group and subscribe to our YouTube channel to keep up with our newest features, improvements, and helpful video tutorials.
