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 Premium Templates abilities: Insert Premium Template.
Insert Premium Template puts a ready-made section from the Premium Templates catalog onto one of your Elementor pages. The section lands as real Elementor elements you can edit, its media is copied into your own media library, and any inner templates it renders are added to your template library, or reused if you already have them.
Whatever is already on the page stays. The section is added at the end, or at a position you pick, and the ability hands back the IDs of the new elements so your assistant can go straight on to rewriting the text and swapping the images.
Run List Premium Templates before this one. It is where template_id comes from, and it caches the catalog data this ability reads.
At a Glance
| Category | Premium Templates |
| Access | Write |
| Destructive | No |
| MCP tool name | premium-addons/insert-premium-template |
| Available since | Premium Addons v4.11.100 |
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 → MCP Config & AI Abilities, in the Premium Templates category:
Use Cases
Build a page out of ready-made sections. Ask for a hero, then a features row, then testimonials, and each one lands on the page in the order you asked for it.
Put the section exactly where you want it. position is a zero-based index among the page’s top-level elements, so a new hero can go above everything already there.
Make it yours in the same conversation. The returned element IDs feed straight into the element-editing abilities, so “change the heading and use this image instead” is your next message rather than a new task.
💡 Tip: many of the sections in the Premium Templates catalog are part of Premium Addons PRO. With a PRO licence your AI can insert any section in the catalog instead of only the free ones. Upgrade to PRO »
Good to Know
- Run List Premium Templates first. It caches the catalog data this ability needs, and without it you get “No catalog data is cached for this template yet. Call premium-addons/list-premium-templates first, then retry.” The two calls do not have to be back to back: your site keeps one shared index whose clock resets every time any search runs, so a section stays insertable for as long as your AI keeps browsing, and the whole index drops out at once after a full day with no search.
- Existing content on the page is never removed. The section is added to it.
- The target has to be an Elementor document: any page, post, or custom post type built with Elementor, or any item in your Elementor template library.
- Two requirement notes are hard stops: a section noted woocommerce needs WooCommerce active, and one noted form needs Contact Form 7. Every other note is passed back as a warning and does not stop the insert.
- Media in the section, images along with things like Lottie files and SVGs, is copied into your media library. Elementor’s own placeholder images are left where they are. Anything the copy fails on is reported as a
failed_mediawarning and keeps the original catalog address, so an element whose file WordPress simply refuses to sideload goes on rendering from premiumtemplates.io, while one whose address is dead renders empty and the warning tells you which URL to replace. - Some sections render inner Elementor templates, and those come along with the section. They are matched in your library by title, and only against published templates, so a template of your own that shares the title is reused as it is rather than overwritten, while a same-titled draft is not seen and a duplicate is created. Anything created is added as a published section template under Templates, and nothing removes it later. One section in the catalog brings ten.
- Every element ID is regenerated, so the new elements never collide with what is already on the page.
- PRO sections need a valid Premium Addons PRO licence. Without one the catalog withholds the section and the ability returns “This template requires Premium Addons Pro.” Upgrade to PRO »
- Running it twice inserts the section twice, and the second run reports fewer warnings than the first, because the inner templates already exist and are not imported again.
- Once the insert goes through, almost nothing is dropped silently: whatever could not be reproduced comes back in
warnings, with repeats collapsed. The exception is stored query filters inside listing widgets, which are cleared without a warning because they point at post and term IDs that mean nothing on your site. - The connected WordPress user needs to be able to edit the target page and to upload files, Elementor has to be active, and Premium Templates has to be switched on under Premium Addons → Features. A
post_idthat does not exist fails this permission check rather than reporting a missing page.
Inputs
| Parameter | Required | Description |
|---|---|---|
template_id | Yes | The template_id from List Premium Templates. Run that ability first: it caches the catalog data this one reads. |
post_id | Yes | The ID of the Elementor page, post, or template to insert into. Existing content is never removed. |
position | No | Zero-based position among the page’s top-level elements. Omit to add the section at the end. |
Output
| Field | Description |
|---|---|
inserted_element_ids | IDs of the new top-level elements, ready for the element-editing abilities. |
post_id | The page the section was inserted into. |
edit_url | The Elementor editor URL for the page. |
templates | The inner Elementor templates that were created or reused. Each one gives its title, its ID on your site so you can go and edit it, and which of the two happened. One that failed is not listed here and comes back as a template_failed warning instead. |
warnings | Problems that did not stop the insert, each with a type and a detail. |
Five kinds of warning can come back:
- notice passes on a requirement note from the catalog. The detail is a bare slug such as container, facebook, or google rather than a sentence, and because nearly every section carries container, almost every insert returns one.
- missing_widget means the element is not installed or is switched off here, so it was kept on the page but will not render. Activating or re-enabling it brings the element back. The detail is the widget type, or the element type for a non-widget element.
- failed_media means a file could not be copied and the original address was kept. The detail is that address.
- pro_gated means the element is neither an Elementor core widget nor a free Premium Addons widget, so building with it needs Premium Addons PRO and third-party widget support switched on. The element itself still renders normally as long as the plugin that owns it is active. The detail is the widget type.
- template_failed means an inner template could not be created, so whatever renders it stays empty. The detail is the template title, or its catalog ID when the catalog gave no title.
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.
