Button is a WordPress ability from The Plus Addons for Elementor — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Button
WriteAdds the The Plus "Button" widget (tp-button) to an Elementor container.
Requires the The Plus Addons for Elementor plugin (which registers under the 'tpae' ability category) on WordPress 6.9+, with Elementor active. Every ability requires the current user to have the 'edit_posts' capability (and 'edit_post' for the specific post being modified); abilities that create or edit content also verify Elementor and, where relevant, the target The Plus widget are available. A subset of abilities (theme templates, template conditions, dynamic tags, popups, and some custom-code abilities) only register when Elementor Pro is active, and many widget abilities load only in the free plugin when the Pro add-on is inactive.
What it does
The execute_callback tpae_mcp_add_theplus_button_ability() reads the target post's Elementor page data, builds a widget element of type tp-button from the mapped input settings (button type, style, alignment, hover style, text, link, icon options, custom attributes, and extensive color/border/spacing/effect controls), inserts it into the specified parent container at the requested position, and saves the updated Elementor data back to the post. It requires Elementor to be active and the tp-button widget to be registered, and requires post_id, parent_id, and button_text, with the target post existing.
See it in action
You ask your AI assistant
"Add a Button widget to container hero-cta on page 5 with button_text 'Get Started' using style-3 and linking to https://example.com/signup."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| post_id | integer | Yes | Elementor page/post ID |
| parent_id | string | Yes | Target Elementor container ID |
| position | integer | No | Insert position. Use -1 to append. |
| button_type_switch | string | No | Button Type (enum: basic, icon, toggle) |
| button_global_style_preset | string | No | Global Style |
| button_style | string | No | Button Style (enum: style-1..style-24) |
| button_align | object | No | Alignment |
| btn_hover_style | string | No | Button Style |
| button_text | string | Yes | Text |
| button_24_text | string | No | Button Tag Text |
| button_hover_text | string | No | button_hover_text |
| button_link | object | No | Link |
| button_custom_attributes | string | No | Add Custom Attributes (enum: yes, no) |
| custom_attributes | string | No | Custom Attributes |
| adv_button_icon_5 | string | No | Icon Library |
| adv_before_after | string | No | Icon Position (enum: after, before) |
| icon_hover_style | string | No | Icon Hover Style |
| button_icon_style | string | No | Icon Font |
| font_awesome | string | No | Font Awesome (enum: yes, no) |
| button_icon | string | No | Icon |
| font_awesome_5 | string | No | Font Awesome 5 (enum: yes, no) |
| button_icon_5 | string | No | Icon Library |
| iconmind_options | string | No | iconmind_options |
| icon_circl_size | object | No | Circle Size (Slider/Size Object) |
| before_after | string | No | Icon Position |
| icon_spacing | object | No | Icon Spacing (Slider/Size Object) |
| icon_size | object | No | Icon Size (Slider/Size Object) |
| button_css_id | string | No | Button ID |
| button_margin | object | No | Margin (Dimensions Object) |
| button_padding | object | No | Padding (Dimensions Object) |
| button_svg_icon_size | object | No | SVG Icon Size (Slider/Size Object) |
| btn_text_color | string | No | Text Color (Color Hex/RGBA) |
| btn_icon_color | string | No | Icon Color (Color Hex/RGBA) |
| icon_fill_color | string | No | Fill (Color Hex/RGBA) |
| icon_stroke_color | string | No | Stroke (Color Hex/RGBA) |
| button_border_style | string | No | Border Style |
| button_border_width | object | No | Border Width (Dimensions Object) |
| button_border_color | string | No | Border Color (Color Hex/RGBA) |
| button_radius | object | No | Border Radius (Dimensions Object) |
| button_radius_18 | object | No | Border Radius (Dimensions Object) |
| btn_bottom_border_color | string | No | Border Color (Color Hex/RGBA) |
| bottom_border_height | object | No | Border Height (Slider/Size Object) |
| btn_text_hover_color | string | No | Text Color (Color Hex/RGBA) |
| btn_icon_color_hover | string | No | Icon Color (Color Hex/RGBA) |
| icon_fill_color_hover | string | No | Fill (Color Hex/RGBA) |
| icon_stroke_color_hover | string | No | Stroke (Color Hex/RGBA) |
| hover_button_border_style | string | No | Border Style |
| hover_button_border_width | object | No | Border Width (Dimensions Object) |
| button_border_hover_color | string | No | Border Color (Color Hex/RGBA) |
| button_radius_hover_18 | object | No | Border Radius (Dimensions Object) |
| button_hover_radius | object | No | Border Radius (Dimensions Object) |
| btn_bottom_border_hover_color | string | No | Border Color (Color Hex/RGBA) |
| btn_tag_text_color | string | No | Button Tag Color (Color Hex/RGBA) |
| btn_magic_scroll | string | No | Magic Scroll (enum: yes, no) |
| btn_magic_scroll_options | string | No | btn_magic_scroll_options |
| plus_tooltip | string | No | plus_tooltip (enum: yes, no) |
| plus_tooltip_options | string | No | plus_tooltip_options |
| btn_special_effect | string | No | Special Effect (enum: yes, no) |
| btn_special_effect_options | string | No | btn_special_effect_options |
| plus_mouse_move_parallax | string | No | Mouse Move Parallax (enum: yes, no) |
| plus_mouse_move_parallax_options | string | No | plus_mouse_move_parallax_options |
| plus_continuous_animation | string | No | plus_continuous_animation (enum: yes, no) |
| plus_continuous_animation_options | string | No | plus_continuous_animation_options |
| full_width_btn | string | No | full_width_btn (enum: yes, no) |
| btn_hover_effects | string | No | btn_hover_effects |
| btn_hover_effects_pro | string | No | btn_hover_effects_pro |
| hover_shadow_color | string | No | Shadow Color (Color Hex/RGBA) |
| shake_animate | string | No | shake_animate (enum: yes, no) |
| shake_animate_duration | string | No | Interval Shake Duration |
| settings | object | No | Raw Elementor control key/value pairs to merge. Supports 24+ stylistic hover presets, dynamic SVG pathing, and responsive kinetic geometry. |
Returns
Returns element_id (string), widget_type (string), and post_id (integer) of the created widget.
Permission
Requires the current user to have the edit_posts capability, and if a post_id is provided, also requires edit_post capability on that specific post.
More The Plus Addons for Elementor abilities
Accordion
Adds The Plus Addons "Accordion" widget (tp-accordion) to an Elementor container.
Add Code Snippet
Creates a site-wide Custom Code snippet using Elementor Pro, injecting CSS/JS/meta into the head or body on all pages.
Add Container
Adds a new Elementor flex container to a page or nests it inside another existing container.
Add Container
Adds a flex or grid container to a page, optionally nested inside a parent container.
Add Custom CSS
Adds custom CSS to a specific element or to the entire page (requires Elementor Pro).
Add Custom JavaScript
Adds a custom JavaScript snippet to a page by inserting an HTML widget containing a <script> tag; works with free Elementor.