Get Widget Usage Map is a WordPress ability from Ultimate Addons for Elementor — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Get Widget Usage Map
Read-onlyReturns site-wide usage counts for HFE widgets across all Elementor pages, posts, and templates.
Requires the Ultimate Addons for Elementor (Header Footer & Elementor) plugin on WordPress 6.9+ (the WP Abilities API). No ability registers unless the plugin's 'Enable AI Tools' master switch (uae_mcp_settings.enable_abilities) is turned on in settings. Most abilities require the 'manage_options' capability; a smaller set of read/discovery abilities (template and page listing, the Elementor builder read/list/schema abilities, active-template lookup, display-rule locations, and design tokens) instead require only 'edit_posts' or 'read'. Abilities that act on a specific page, post, or template additionally check the current user's per-object 'edit_post' (or 'delete_post') capability on that item. Separately, every non-readonly (Write or Destructive) ability is gated behind a site-wide 'Allow Modifications' setting at registration time: if it is off, none of those abilities are even registered with the WP Abilities API, regardless of capability checks — this covers all template/page CRUD, widget/extension toggles, display-rule updates, theme/settings changes, and the Elementor builder writes alike, not just the builder ones. Eight of those abilities (the seven Elementor page-builder writes — build, insert-widget, update-widget, remove-element, move-element, add-section, add-column — plus pages-create) additionally re-check this same setting explicitly inside execute() as a redundant safeguard.
What it does
Optionally accepts a widget_slug filter (returns 404 if that slug doesn't correspond to a known widget). Uses a site-wide usage count map derived from Elementor's Usage Module and widget titles/active flags. For each requested slug (or all known slugs if unfiltered), it returns the slug, title, is_active flag, and usage_count (0 if unused). Meant to be checked before deactivating widgets to see if they're actively used.
See it in action
You ask your AI assistant
"Which HFE widgets are actually being used on the site, and how many times is each one used?"
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| widget_slug | string | No | Optional. Filter to a single widget slug. |
Returns
An object with a widgets array (each item: widget_slug, title, is_active, usage_count) and a count integer.
Permission
Requires current_user_can('manage_options'); no additional execute-time gating besides the optional slug validation.
More Ultimate Addons for Elementor abilities
Activate Widget
Enables a specific HFE widget by its slug.
Add Column to Section
Adds a new column to an existing section or container in an Elementor post, redistributing column widths automatically.
Add Section/Container
Adds a new structural layout element (a section with columns on legacy sites, or a flex container on container-mode sites) to an Elementor post.
Build Complete Layout
Builds a complete Elementor layout — sections, columns, and widgets — from a single JSON structure, replacing all existing content on the target post.
Bulk Toggle All Widgets
Activates or deactivates every HFE widget at once.
Clear Elementor Cache
Clears the Elementor CSS cache globally to regenerate all stylesheets.