# Goldnat for Elementor

Create pages, edit widgets, manage global styles, upload media, export/import templates — all through goldnat.ai or any Servio-compatible agent.

- Platform: WordPress
- Edition: paid add-on
- Web page: https://plugins.goldnat.ai/wordpress/elementor-ai-connect
- Installation guide: https://plugins.goldnat.ai/wordpress/guide
- Requires: Goldnat for WordPress (https://plugins.goldnat.ai/wordpress/wordpress-plugin.md)

## What you can ask the agent

- "Change the hero headline on the home page." — The agent finds the element in the Elementor page and updates only that text.
- "Make the brand colour a slightly darker blue across the site." — It updates the global colour, so every widget that uses it changes together.
- "Duplicate the landing page for the autumn campaign." — It copies the page with its layout as a new draft.
- "Which pages still use the old testimonial widget?" — It searches your pages for that widget and lists where it appears.
- "Save this section as a template I can reuse." — It saves the element as an Elementor template.
- "Roll the pricing page back to yesterday's version." — It lists the page revisions and restores the one you pick.

## Install and connect

1. Install the free core plugin first: Goldnat for WordPress (https://plugins.goldnat.ai/wordpress/wordpress-plugin). This plugin runs on top of it.
2. Buy Goldnat for Elementor at goldnat.ai, download it, and upload it in your WordPress admin panel. Enter the license key you receive.
3. Connect your AI agent: in goldnat.ai (or another compatible agent) add your site address. You are sent to your own WordPress site to log in and approve what the agent may do (read only, or read and write).
4. Ask the agent in plain language. It calls the plugin on your site as you, and shows you the result.
5. Full installation guide with screenshots: https://plugins.goldnat.ai/wordpress/guide

## What the agent can and cannot do

- The agent acts as the WordPress user who connected it. It can never see or change more than that user can.
- You approve the access level when you connect (read only, or read and write), and you can revoke the connection at any time from the plugin page in your admin panel.
- Actions that delete content or cannot be undone ask for an explicit confirmation first.
- Your content stays on your site. The plugin answers the agent's requests directly; it does not copy your site anywhere else.

## Tools

Each tool is called by the agent by name. "write" tools need write access approved at connection.

- `elementor.addElement` (write) — Insert a new element into a page at a specific parent + position. Auto-generates ID if not given.
- `elementor.analyzePagePerformance` (read) — Metrics for one page: widget count, tree depth, data size, unique widget types, custom CSS size.
- `elementor.applyKit` (admin) — Set the active Kit (elementor_active_kit option) to a specific kit post ID. Flushes CSS.
- `elementor.batchUpdateElements` (write) — Apply many updateElement patches in one call — decodes/encodes once, single CSS flush at end.
- `elementor.createPage` (write) — Create a new WordPress page with Elementor enabled (all required postmeta). Optionally seed initial _elementor_data.
- `elementor.createTemplate` (write) — Create a new empty Elementor template (elementor_library post) with a given type.
- `elementor.deleteMedia` (delete) — Delete a media library item.
- `elementor.deletePage` (delete) — Delete an Elementor page (trash or force-delete). Force-delete is irreversible.
- `elementor.deleteTemplate` (delete) — Delete a template by ID.
- `elementor.duplicateElement` (write) — Clone an element (with children) as a sibling. Regenerates fresh 8-char IDs across the whole subtree.
- `elementor.duplicatePage` (write) — Duplicate an Elementor page: clones the post + every _elementor_* postmeta into a new draft.
- `elementor.exportPage` (read) — Export one page as portable JSON (title, template_type, _elementor_data, _elementor_page_settings).
- `elementor.exportSite` (read) — Export EVERY Elementor page + template + active kit as one JSON blob. Large payload.
- `elementor.exportTemplate` (read) — Export a template as portable JSON (Elementor .json export shape).
- `elementor.findElements` (read) — Search a page tree by widget type, element css_id, or text substring. Returns matching IDs + paths.
- `elementor.findWidgetUsage` (read) — Find every page/template using a given widget type. Returns pages + per-page count.
- `elementor.flushCSSCache` (admin) — Clear Elementor's generated CSS cache — site-wide or per-page. Every WRITE tool already flushes; call this explicitly after bulk operations.
- `elementor.generateCriticalCSS` (admin) — Generate above-the-fold Critical CSS for a page. Requires an external service (e.g. Critical CSS plugin); returns a stub + hint when unavailable.
- `elementor.getBreakpoints` (read) — Elementor responsive breakpoints (mobile/tablet extra/laptop widescreen values).
- `elementor.getCustomCSS` (read) — Get site-wide custom CSS from the active Kit (elementor_kit._custom_css) OR page-level custom CSS.
- `elementor.getEditorSettings` (read) — Elementor editor-level settings (page title selector, cpt_support, disable default colors etc.).
- `elementor.getElement` (read) — Fetch a single element (container or widget) by its 8-char ID from a page.
- `elementor.getElementResponsiveSettings` (read) — Return the per-device settings blob of an element (desktop/tablet/mobile keys).
- `elementor.getExperiments` (read) — List Elementor experiments (feature flags) with current state (active/inactive/default).
- `elementor.getGlobalColors` (read) — Just the global color palette (system + custom) from the active Kit.
- `elementor.getGlobalFonts` (read) — Global typography presets (Primary/Secondary/Text/Accent) from the active Kit.
- `elementor.getGlobalSettings` (read) — Get the active Kit's global colors, typography presets, and site-wide settings.
- `elementor.getMediaItem` (read) — Get one attachment: URL, sizes, metadata, alt text.
- `elementor.getPageData` (read) — Full raw _elementor_data + _elementor_page_settings for one page. Large payload — prefer getPageStructure when you only need the map.
- `elementor.getPageRevisions` (read) — List WordPress revisions of an Elementor page — for rollback / audit.
- `elementor.getPageStructure` (read) — Compact element-tree map of a page: IDs, elType, widgetType, brief text preview. Cheap to fetch (no full settings blob).
- `elementor.getSystemInfo` (read) — Elementor + WP system info (versions, active plugins, PHP/DB versions) — for debugging support requests.
- `elementor.getTemplate` (read) — Fetch full data of a saved template (elementor_library post): title, type, _elementor_data.
- `elementor.getWidgetSchema` (read) — Return the control schema for a widget type — setting keys, types, defaults and options. Read this BEFORE calling updateElement so you use correct keys. Default: Content tab only; tab=style, advanced or all (real editor tabs, incl. style controls such as title_color / typography_*), or section to narrow further.
- `elementor.importPage` (write) — Import a single page from a portable JSON payload.
- `elementor.importSite` (admin) — Import an exportSite payload back. Creates pages + templates + optionally sets active kit.
- `elementor.importTemplate` (write) — Import a template from a JSON payload (Elementor .json export format).
- `elementor.listKits` (read) — List installed Elementor kits with active-kit indicator.
- `elementor.listMedia` (read) — List media library items with basic metadata. Filter by type + search.
- `elementor.listPages` (read) — List all pages/posts built with Elementor. Filter by status/post_type/search.
- `elementor.listRegisteredWidgets` (read) — List all registered widget TYPES available on this install (including third-party addon widgets).
- `elementor.listTemplates` (read) — List saved Elementor templates (elementor_library). Filter by template_type (page/section/header/footer/popup/kit).
- `elementor.listUnusedAssets` (read) — List media library items that no Elementor page references (candidates for cleanup).
- `elementor.listWidgetsInPage` (read) — Count each widget type used inside one page — histogram of usage.
- `elementor.minifyCustomCSS` (admin) — Minify the site-wide custom CSS in the active Kit (whitespace/comment strip). Reversible via getCustomCSS backup.
- `elementor.moveElement` (write) — Move an element to a different parent and/or position within the same page. Rejects circular nesting.
- `elementor.optimizeImages` (admin) — Trigger image optimization for a page's attachments. Delegates to any registered optimizer plugin (Smush, ShortPixel, Optimole); no-op with a report if none is present.
- `elementor.publishPage` (write) — Publish or unpublish a page. Convenience wrapper over updatePageMeta.
- `elementor.regenerateCSS` (admin) — Regenerate ALL Elementor CSS (equivalent to Tools → Regenerate CSS in the admin).
- `elementor.removeElement` (delete) — Remove an element (and all its children) from the page tree by ID. Fails silently if not found.
- `elementor.restoreRevision` (write) — Restore a specific revision as the current version of the page. Regenerates CSS after restore.
- `elementor.saveAsTemplate` (write) — Save an existing page (or one of its elements) as a reusable template.
- `elementor.savePageData` (write) — Replace the entire _elementor_data tree of a page with a new JSON array, then flush CSS cache.
- `elementor.searchContent` (read) — Full-text search across all Elementor page/template content — case-insensitive substring match on _elementor_data.
- `elementor.setFrontPage` (admin) — Set the site home page (Settings → Reading): page_id becomes the static front page (show_on_front=page, page_on_front); page_id=0 shows the latest posts instead. Optional posts_page_id sets the blog page. Needs manage_options. Changes what every visitor sees on the home page.
- `elementor.toggleExperiment` (admin) — Set an Elementor experiment on/off/default.
- `elementor.updateBreakpoints` (write) — Update Elementor's responsive breakpoint values.
- `elementor.updateCustomCSS` (write) — Set custom CSS (global via active Kit, OR page-level via _elementor_page_settings). Flushes CSS.
- `elementor.updateEditorSettings` (admin) — Update Elementor editor settings via option merge.
- `elementor.updateElement` (write) — Shallow-merge a settings patch into a specific element by ID, then flush CSS.
- `elementor.updateElementResponsive` (write) — Update an element's responsive settings for a specific device (desktop/tablet/mobile). Applies the settings suffix Elementor uses (e.g. font_size_mobile).
- `elementor.updateGlobalColors` (write) — Update one or more named global colors in the active Kit (matches by _id or title), then flush CSS.
- `elementor.updateGlobalFonts` (write) — Update global typography presets in the active Kit (match by _id or title). Flushes CSS.
- `elementor.updatePageMeta` (write) — Update WordPress-level page metadata: title, slug, status, excerpt. Replaces the older updateStatus/updateTitle single-field tools.
- `elementor.updatePageSettings` (write) — Shallow-merge key/value pairs into _elementor_page_settings (background, padding, hide_title, custom_css…). settings.template sets the page template (_wp_page_template): elementor_canvas, elementor_header_footer, default or a theme template; unknown values are refused with the allowed list.
- `elementor.updateTemplate` (write) — Update a template's title, status, or _elementor_data.
- `elementor.uploadCustomIcon` (write) — Upload a custom SVG icon (Elementor Custom Icons — if plugin/library supports it). Stored as an SVG attachment tagged with elementor-icon.
- `elementor.uploadImage` (write) — Upload an image to the WordPress media library from a URL or base64 payload.

## Frequently asked questions

**Which AI agents can I use?**

Our own agent at goldnat.ai, and other AI agents that support the Servio protocol. The list of compatible clients is on this page.

**Can the AI see or change things I can't?**

No. It works as the WordPress user who connected it, with exactly that user's permissions. Connect it with an account that has only the access you want it to have.

**Will it change things without asking?**

Only if you approved write access when you connected it. Deleting or irreversible actions ask for an explicit confirmation.

**How do I disconnect an agent?**

Revoke its connection from the plugin page in your admin panel. The agent loses access immediately.

**Do I also need Goldnat for WordPress?**

Yes. Goldnat for Elementor runs on top of the free core plugin, which handles the secure connection.

## Guides

- [Managing Many WordPress Sites with an AI Agent](https://plugins.goldnat.ai/docs/06-managing-many-wordpress-sites) — A practical guide for agencies and freelancers who look after several WordPress sites — how to connect one AI agent to all of them with the Goldnat plugins, what it can check and change on each site, how permissions and confirmations keep it safe, and a weekly routine you can copy.
