Description
IATO MCP turns a self-hosted WordPress site into an MCP server. Connect Claude, or another AI client that supports MCP, and ask it in plain words to edit pages, fix SEO, rebuild menus, restructure URLs or work through a site audit.
The AI client can preview a change with a dry run before making it, and any change it makes can be undone with one call. The plugin understands Elementor, including Theme Builder and the Atomic Editor, and works with the SEO, redirect, theme and cache plugins many sites already use. Add an IATO account and the same conversation can crawl your site, find what needs fixing, and fix it.
How it works
- Install and activate the plugin.
- Open the setup wizard and copy your MCP server URL. It looks like
https://example.com/wp-json/iato-mcp/v1/message. - In Claude, add a custom connector with that URL, then approve the connection on your WordPress site. Clients that use a config file connect with a WordPress Application Password instead, and the wizard gives you the config.
- Optional: add an IATO API key under Settings > IATO MCP for crawl-based audits. IATO’s Free plan covers 500 pages per crawl.
What Claude can do
The plugin has 64 WordPress tools. 57 are on when you install it. The 7 page asset tools stay off until an administrator turns them on. You can switch any tool off under Settings > IATO MCP.
Posts and pages
- Read, search, create and edit posts and pages: title, content, slug, excerpt, status, publish date and author
- Schedule posts, and move pages under a parent page
- Change the permalink structure, with 301 redirects from the old URLs
- Read and write post meta. Keys that look like credentials are refused.
- Set per-page theme settings (hide title, sidebar and content layout) on Astra, Kadence, GeneratePress and Elementor
- Read and filter comments
Elementor
- Detect which page builder a page uses (Elementor, Gutenberg, Divi, WPBakery, Beaver Builder or the classic editor), so the AI client edits it with the right tools
- Edit one widget, many widgets across many pages, or a whole page, with revision checks so that two edits cannot overwrite each other
- Apply JSON Patch (RFC 6902) edits to a page
- Fix heading levels, text, links and image alt text on Atomic Editor (V4) elements (Elementor 4.3.0 or later), checked with Elementor’s own code
- Copy the styling of an existing page in one call with
inherit_settings_from - Create Theme Builder templates, such as a site-wide header and footer, and set where they show (Elementor Pro)
- Find which page renders a URL, and which Theme Builder header and footer it gets
SEO
- Update SEO titles, meta descriptions and canonical URLs
- Add JSON-LD structured data
- Create redirects
- Update image alt text
Site, menus and media
- Set the site title, tagline, home page, site icon and logo
- Read and set the theme’s Additional CSS
- Change the public fields of a user’s profile, such as the display name
- Create menus, add, edit and remove menu items, and assign menus to theme locations
- Manage categories, tags and other taxonomy terms
- Upload images to the Media Library in checked chunks, and set featured images
Page assets (off until an administrator turns them on)
- Give one page its own CSS and Elementor fonts
- Store a script for one page. It runs only after an administrator approves it in wp-admin.
- Make expiring preview links, so the AI client can check a draft before it is published
Safety
- Every change returns a receipt. Pass its
change_idtorollbackand the old value is restored. Each receipt records the user and the connection that made the change. dry_runshows what a change would do without saving it.- Content written through MCP is filtered whatever the user’s role, and each response says what was removed (
sanitized_report). - Page caches are purged after each change. The response names any cache the plugin cannot reach, such as Cloudflare.
- Each OAuth connection gets its own expiring token, acts as the administrator who approved it, and can be revoked on its own.
With an IATO account: 12 more tools, for administrators
- Start a crawl of your site, check its status and list recent crawls
- Get SEO issues (titles, meta descriptions, alt text) mapped to WordPress posts, ready for the tools above to fix
- Find orphan pages that no navigation menu links to, and gaps in your menus
- Map broken links to the posts that contain them
- Find thin content, with specific improvements
- Review categories and tags and get suggested consolidations
- Get AI-prioritized suggestions across SEO, content, links and performance
- Flag slow pages, with what makes them slow
On WordPress 6.9 or later, the IATO read tools are also registered as WordPress Abilities, for MCP servers built on the WordPress MCP Adapter.
Supported plugins
- SEO: Yoast SEO, Rank Math and SEOPress. Without one, the plugin reads the WordPress title, and SEO fields cannot be changed.
- Redirects: Redirection or Safe Redirect Manager, or the plugin’s own list when neither is active
- Page builders: Elementor, and Elementor Pro for Theme Builder
- Themes with per-page settings: Astra, Kadence and GeneratePress
- Page caches: LiteSpeed Cache, WP Rocket, W3 Total Cache, WP Super Cache, WP Fastest Cache and SiteGround Optimizer
Example prompts
“Crawl my site and fix all missing meta descriptions”
“Show me pages that aren’t in any navigation menu and add them to the right place”
“What are the most impactful improvements I can make to my site right now?”
“Find all broken links and tell me which posts contain them”
“Move the service pages under a new Services page and redirect the old URLs”
“Schedule this draft for Monday at 9am and make Sam the author”
“Change the extra H1 headings on these Elementor pages to H2”
“Build a site-wide footer with our address and the main menu”
“Find all button widgets on the site and change their color to #ff0000”
External services
This plugin connects to the IATO API (https://iato.ai) once an administrator enters an IATO API key under Settings > IATO MCP. Nothing is sent to IATO before then. With a key saved, the plugin calls https://iato.ai/api when the key is tested and when an AI client uses one of the IATO tools. It sends the API key, and your site’s URL when a crawl is started. It receives crawl data about your public pages: SEO audit results, sitemap information, broken links and AI-generated suggestions.
The IATO platform can also read your site. If you give IATO the site’s API key from Settings > IATO MCP, for example to use the IATO dashboard’s “Sync pages, posts, menus, and taxonomy from WordPress”, IATO uses the plugin’s read tools to copy posts, pages, menus and taxonomy into your IATO project. It cannot do this without that key, and regenerating the key stops it.
Image uploads from a URL are off by default. When an administrator turns them on, create_media downloads images only from the hosts the administrator lists.
The plugin also runs an OAuth 2.1 authorization server on your WordPress site, so that MCP clients such as Claude can connect through the standard “Add custom connector” flow. That exchange is between the MCP client and your site. No data is sent to third parties during authentication.
Installation
- Install the plugin from Plugins > Add New, or upload it to
/wp-content/plugins/iato-mcp/. - Activate it.
- Open the setup wizard, from the notice that appears or from the link under Settings > IATO MCP. It shows your MCP server URL.
- In Claude (claude.ai or Claude Desktop), add a custom connector, paste the MCP server URL and click Connect. Claude sends you to your WordPress site: log in as an administrator and approve the connection.
- For a client that uses a config file instead, create an Application Password under Users > Profile and use the config the wizard gives you.
- Optional: under Settings > IATO MCP, enter an IATO API key for the IATO tools. Use a separate IATO API key for each client site: a key gives access to every crawl in its IATO account, so a key shared between sites lets one site’s administrators see the others’ crawl data.
For detailed setup instructions, see the IATO MCP documentation.
FAQ
Do I need an IATO account?
No. The plugin’s 64 WordPress tools work without one, and 57 of them are on by default. An IATO account adds 12 tools for administrators: starting, checking and listing crawls, SEO audit, broken links, content gaps, orphan pages, navigation audit, taxonomy analysis, AI suggestions, performance reports and the sitemap. IATO’s Free plan covers 500 pages per crawl. If you manage several client sites, give each site its own IATO API key: a key can read every crawl in its account.
Which WordPress version is required?
WordPress 6.2 or later, with PHP 8.0 or later. A few features need more:
- Keeping inline SVG and style blocks in Elementor HTML widgets: WordPress 6.5
- WordPress Abilities for the IATO tools: WordPress 6.9
- Editing Atomic Editor (V4) elements: Elementor 4.3.0
- Theme Builder templates and their display conditions: Elementor Pro
Does this work on shared hosting?
Yes. The plugin uses standard HTTP requests (one per MCP call) rather than long-lived connections, so it works on all hosting environments including shared hosting.
Which AI clients are supported?
Any MCP client that can connect to a remote server over Streamable HTTP. In Claude (claude.ai and Claude Desktop), add the site as a custom connector. Claude Code, Cursor, VS Code and other clients connect with the server URL. Clients that only start local servers connect through the mcp-remote bridge, with the config the setup wizard gives.
How does authentication work?
There are three ways to connect, all to the same endpoint, /wp-json/iato-mcp/v1/message:
- OAuth 2.1 (recommended). Claude’s “Add custom connector” flow uses it. An administrator approves the connection on your site. Each connection gets its own expiring token, acts as the administrator who approved it, and can be revoked on its own under Settings > IATO MCP > Connected OAuth clients.
- Application Password. For clients that use a config file or plain HTTP. Requests act as the WordPress user the password belongs to, who needs at least the
edit_postscapability, and each tool checks that user’s permissions. Revoke the password under Users > Profile. - Site API key (Bearer token). The plugin generates it on activation and shows it under Settings > IATO MCP. The IATO platform’s integrations use it, and so can HTTP clients you configure yourself. Requests act as the administrator assigned as the key’s owner. Regenerate the key to cut off everything that uses it.
Is my content sent to IATO or Anthropic?
The plugin itself never sends your posts or pages to IATO. It sends IATO only your API key, and your site’s URL when a crawl is started. IATO crawls your public pages the way a search engine does. If you give the IATO platform your site’s API key to sync your content, IATO reads posts, pages, menus and taxonomy through the plugin (see External services).
Whatever your AI client reads through the plugin goes to the company that runs that client, such as Anthropic for Claude, and is handled under that company’s terms. Turn off any tool you do not want AI clients to use.
A page lost an embed or script after an IATO edit. How do I repair it?
Open the page in Elementor, go to History, then Revisions, and apply the last revision saved by a person before the first IATO edit. Then re-apply the IATO changes you want to keep. If revisions are disabled on the site, there is no earlier copy to restore.
A page edited with IATO shows a missing link or image, or Elementor will not save it
IATO 1.13.0 and earlier could store a plain value on an Elementor Atomic Editor (V4) element, such as a heading, paragraph, image or button built with the Atomic Editor, where Elementor expects a typed value. Elementor then drops a link or image it cannot read, and saving the page in Elementor fails with “Settings validation failed”.
To find the affected elements, read the page with get_elementor_data, get_elementor_widget, list_elementor_widgets or find_elementor_widgets. Since 1.13.1 they flag the element with stored_value_invalid: true, and invalid_keys names the settings to repair; get_elementor_data also lists them under invalid_elements.
To repair an element, send each listed setting again with update_elementor_widget, set_widget_setting or set_heading_level. From 1.14.0 (with Elementor 4.3.0 or later) the plain value works, for example {“tag”: “h2”} or {“link”: {“destination”: “https://example.com/”}}: IATO stores it in Elementor’s format and the element is repaired. With 1.13.1, or on a site without Elementor 4.3.0, send it as a typed value, in the shape get_elementor_widget shows under settings for the element, for example {“tag”: {“$$type”: “string”, “value”: “h2”}}. When several elements on a page are affected, repair them one at a time; Elementor saves the page normally again once the last one is repaired. A damaged element cannot be copied (update_elementor_patch refuses the copy): repair the source first, then copy it. You can also restore a revision saved before the IATO edit, under History, then Revisions, in Elementor.
Can IATO edit Elementor Atomic Editor (V4) elements?
Yes, from 1.14.0, with Elementor 4.3.0 or later and the Atomic Editor turned on. set_heading_level, set_widget_setting, update_elementor_widget, update_elementor_widgets_bulk and update_elementor_patch take plain values for atomic headings, paragraphs, buttons, images and containers, and update_alt_text takes post_id and element_id for an atomic image. IATO converts and validates each value with Elementor’s own code and keeps every setting the call does not name as it was stored. Changes go live, like edits to classic widgets, and each one can be rolled back on its own.
The alt text of an image from the Media Library belongs to the attachment, so IATO changes it there, and the change applies everywhere that image is used. Global classes and component instances are not edited by IATO yet. On sites with an older Elementor, IATO accepts only typed values for atomic elements and says what is missing. While the Atomic Editor is off, IATO does not change atomic elements at all, because Elementor cannot check them; the rest of the page can still be edited.
Why do visitors still see the old page after a change?
IATO purges the cache plugins it finds after each change and says what happened in the tool’s cache object. A cache in front of WordPress, such as Cloudflare or a host’s CDN, is out of its reach: the response names it in cache.notes so the AI client can tell you to purge it from that service’s dashboard. On Hostinger, LiteSpeed’s full purge also clears hCDN when Hostinger Tools 3.0.79 or later is active. A single-page purge cleared it too on the Hostinger site we tested, but IATO does not control that, so if a page still looks stale, purge hCDN in hPanel.
Why was a style block or an SVG removed from my HTML widget?
Content written through MCP is filtered, whatever the role of the user behind the connection, and <style> and <svg> are not on the list of allowed tags. The response’s sanitized_report says what was removed from each value. To keep them in Elementor HTML widgets, turn on “Allow inline SVG and style blocks in HTML widgets for administrators” under Settings > IATO MCP. It applies only to a WordPress user who holds both unfiltered_html and manage_options, and needs WordPress 6.5 or later. Scripts, event attributes, javascript: URLs, foreignObject, @import and off-site url() are still removed.
Can I control which tools are available?
Yes. Under Settings > IATO MCP, in the Tools section, turn individual tools on or off. The seven page asset tools (page CSS, fonts, scripts and preview links) start switched off. AI clients read the tool list when they connect, so reconnect the client after a change.
Can AI clients upload arbitrary files to my media library?
Only images, and only when the calling user has the upload_files capability. The create_media tool enforces an image-only MIME allowlist (JPEG, PNG, GIF, WebP, AVIF) verified against actual file bytes. The claimed mime_type is never trusted. SVG uploads are not supported in this release. Files exceeding the size cap (default 10MB) or the dimension cap (default 8000×8000) are rejected, as are filenames containing .php, .phtml, or .htaccess. URL-source ingestion is disabled by default; admins who enable it must also configure a host allowlist, and private/loopback/cloud-metadata IPs are rejected even for allowlisted hosts. Each upload counts against a per-user rate limit (default 20/min) and emits a change_receipt: rolling back fully deletes the attachment file. All four limits are configurable from Settings > IATO MCP.
Images over about 3 KB are sent in pieces with media_upload_start, media_upload_chunk and media_upload_finish. They go through the same checks, the client sends a SHA-256 digest of the whole file, and the upload is refused if the file that arrives does not match it.
Screenshots






Changelog
1.21.1
- Fix:
update_elementor_patch:addat a list index now inserts before the item there, as RFC 6902 says and the tool’s description promised. Since 1.3.0 it replaced the item, so a widget added at an index deleted the widget that stood there.copyto an index overwrote the item there andmoveto an index deleted one; both now insert. An index past the end of a list is refused instead of leaving a gap, and an element cannot be moved into its own children. Usereplaceto overwrite. A page that lost an element this way can be put back by rolling back that write’s receipt within 90 days, or from Elementor’s revisions. - Fix:
update_elementor_patch:removeof an item in the middle of a list left a gap in its numbering, so a later op in the same patch could not find the next item, and the list could be stored as a JSON object. - New: each
update_elementor_patchop on a list item returnslist(where it acted, the list’s length before and after, and its items’ ids afterwards), on dry runs too, so a misplaced insert shows before it is written. - Fix:
stored_matches_inputno longer reads a different key order as a different value. Elementor’s save writes an element’s keys in its own order, so a real write said false where its dry run said true. - Fix: an
addto/-, and an op whose position a later op in the same patch shifted, now getstored_matches_input. They used to get nothing, or be compared with whatever stood at the old position. - New: when the stored value differs,
stored_differencesays how:markup_normalized(the same HTML written differently, such as single quotes rewritten as double quotes),keys_addedorkeys_removed(withadded_pathsandremoved_paths; Elementor’s save dropsisInnerfrom a widget), orchanged. Asanitized_reportentry for a value WordPress rewrote without removing anything now says so; it used to be empty. - Fix:
get_page_fontsandset_page_fontsreport where each Google font is served from (served_from:local,local_after_first_vieworgoogle). Elementor serves a local copy it already holds even with “Load Google Fonts Locally” off, sogoogle_fonts_localwas false on sites that served fonts locally. It now means every Google font on the page comes from this site;local_google_fonts_settinggives the setting itself. - New: Settings > IATO MCP > Tools says that AI clients read the tool list when they connect, and saving a change to the tools says to reconnect the connector. This server cannot tell a connected client that the list changed.
1.21.0
- New:
set_page_cssandget_page_cssgive one page its own CSS, printed in that page’s head only. They follow the same rules as Additional CSS: nothing loaded from another site, at most 200 KB, and anything that would close the style element removed. The CSS is checked again when it is printed. Needs a WordPress user who may edit CSS (administrators and editors) andedit_poston the page. - New:
set_page_fontsandget_page_fontsload Elementor font families on one page only, through Elementor’s own font loader, so “Load Google Fonts Locally” is respected. Families Elementor does not know are refused. - New:
create_preview_linkmakes an expiring URL (15 minutes by default, an hour at most) that shows a draft, pending or scheduled post without a login, so an AI client can check its work. Responses to it are not cached and carry noindex and no-referrer. Rolling back its receipt revokes it, and publishing or trashing the post ends it. Needs permission to publish the post. - New:
set_page_scriptandget_page_scriptstore inline JavaScript for one page. It runs only after an administrator reads it and approves it in wp-admin with their password, and any change waits for approval again. It needs the new “Allow page scripts” setting, off by default, and an administrator who may post unfiltered HTML.<script,</script,<!--and invisible or direction-changing characters are refused, and the approval screen marks every character outside plain ASCII. Turning the setting or the tool off, or deactivating the plugin, stops every page script and purges those pages, even with cache purging off. - New: These seven tools ship switched off. An administrator turns them on in Settings > IATO MCP > Tools. A new “Page assets” tab lists every page with page CSS or fonts and every live preview link, with buttons to remove or revoke them. The Plugins screen warns before the plugin is deactivated, since those pages lose their CSS and fonts while it is off. Uninstalling keeps page CSS and fonts.
- New: HTML in Elementor widgets keeps every
aria-*attribute,inert,disabledandreadonlywhere HTML has them, and<input>with ordinary types (not password, file, image, hidden or submit). Nothing that passed before is removed now: a live check runs a fixture set through 1.20.0’s filter and this one. - New: With “Allow inline SVG and style blocks” on, HTML widgets also keep
ellipse,text,tspan,defs, gradients,stop,marker,clipPath, andusepointing at#idin the same SVG. A@propertysyntaxdescriptor such assyntax:'<number>'is kept in style blocks outside an<svg>(WordPress 6.7 or later). - New: Elementor write responses say for each change whether the stored value is what was sent (
stored_matches_input). When it is not, they say what was stored.update_elementor_widget,update_elementor_patchandupdate_elementor_datatakereturn: "minimal", which returns sizes and hashes instead of whole values. - Fix:
sanitized_reportnow names style declarations WordPress removed fromstyleattributes. When Elementor’s own filter removed more for a user withoutunfiltered_html, that used to be left out of the report. - Fix: a removed
<style>block’s report namesset_page_cssand where to turn it on. - Fix: With “Allow inline SVG and style blocks” on, a value with markup inside an SVG
<title>is no longer kept by the opt-in: a browser reads that markup, while the filter read it as text. Such a value now goes through the ordinary rule.
1.20.0
- New:
update_postandcreate_posttakeparent, for pages and other hierarchical types, andmenu_order. A page’s URL becomes its parent’s URL plus its slug, so /services/web-development/ can be built.parentis refused for posts (parent_not_supported). A page cannot go under itself or a page below it (parent_cycle). The parent must be a page of the same type that the caller can read. A parent that is not published is a warning. - New: A new parent moves the page and every page under it. When any of those URLs can be opened now, the call needs
confirm_url_break. The dry run lists every URL that moves (url_changes) and the redirects it would create. By default each published page’s old URL gets a 301 to its new one (redirect_old_urls), through the same redirect pluginupdate_redirectuses. Creating those redirects needs an administrator; an Editor can passredirect_old_urls: false. One receipt covers the parent, the order and a slug changed in the same call, and its rollback removes the redirects before putting the page back. The whole site’s cache is purged. - New:
update_site_settingstakespermalink_structure,category_baseandtag_base, andget_site_settingsreturns the two bases. A change moves every post and the category, tag and author archives, so it needsconfirm_url_break. The dry run reportsmoved_countand the first 25 URLs. 301 redirects from the old URLs are created by default, up to 1,000; with more, or more than the built-in list or Safe Redirect Manager can hold, none are created and a warning says so. Plain permalinks are refused, and so is a first change away from plain or /index.php/ permalinks, which belongs in Settings > Permalinks. Rollback restores the settings and removes the redirects. - New: The rewrite rules are rebuilt by the next request after a permalink change, as wp-admin does, not in the request that made it. Rebuilding them there would store rules without the ones other plugins add, such as WooCommerce’s account pages, and with category archives at the old URL.
- New: Moving a page back, or changing the permalinks back, with a new call rather than a rollback takes away the redirects the first change left, which would otherwise loop. A redirect someone else set on a URL that a change would make live is refused with
new_url_redirected. - New: A permalink change whose new post URL is already a published page’s URL is a warning, and so is a post slug that does the same: WordPress shows the page there. A page at the start of the new structure, such as /blog/ for /blog/%postname%/, keeps working, including /blog/page/2/.
- New:
get_postandget_postsreturnparentandmenu_order. - Fix:
update_postrefused a page’s slug when any post of any type used it, such as a menu item called “services”. It now uses WordPress’s own rule: a page is compared with pages and attachments under the same parent, a post with posts. A draft is checked as if published, so the slug is not renamed “-2” when it goes live. A slug WordPress reserves, such asfeed, is refused with the slug WordPress would use instead. - Changed: Server instructions add a “Restructuring URLs” section (parent pages first, dry run, apply, then update links in content and menus), and on Elementor sites list
slug,parentandmenu_orderamong the fieldsupdate_postmay change.
1.19.3
- Fix: On sites with Elementor, the instructions the plugin gives AI clients said
update_postcould change onlystatus,titleandexcerpt, so clients were told not to change a post’s date or author with it. The list now includesdate,date_gmt,allow_futureandauthor, and says content edits go through the Elementor tools. - Tests: a unit test checks that every
update_postfield the instructions name is in its input schema.
1.19.2
- New:
get_site_inforeturnsplugin_version, the IATO MCP version running on the site, so one call confirms an update is live. Every caller sees it.
1.19.1
- Changed: The tool descriptions clients read are clearer about publish dates and authors.
create_post‘s description mentions them,dateanddate_gmtsay they are ISO 8601 and thatdate_gmtis worked out fromdatewhen omitted, andallow_futuresays what is refused and when a post is scheduled. - Changed:
create_media‘s description sends files over about 3 KB tomedia_upload_start,media_upload_chunkandmedia_upload_finishinstead of URL ingestion, and says the response carriessha256anddecoded_bytes. - Fix:
get_iato_sitemapreadscrawl_idbut did not list it, so clients could not see it. It is listed now. The WordPress ability already listed it. - Fix:
create_poststores no excerpt, but anexcerptsent with it could appear insanitized_reportas text that was removed. It is now ignored, as the schema says. - Tests: a unit test checks that every tool’s input schema lists exactly the arguments its handler reads, so the two cannot drift apart.
1.19.0
- New:
update_postandcreate_posttakedate(the site’s local time),date_gmt(UTC),allow_futureandauthor. A published post given a future date is refused withfuture_date_on_publishedunlessallow_futureis true, when it is scheduled and the response says so. A draft keeps its status and uses the date when published. Rollback restores the date, the UTC date and the status together. Changing an author needsedit_others_posts, and the new author must be able to edit that type of post. - New:
get_postsreturnsdateanddate_gmt, andget_postreturnsdate_gmt. - Changed:
get_post‘sdateis now the site’s local time, so that it can be sent back toupdate_post. It was UTC: readdate_gmtfor that.modifiedis still UTC. - Changed: Publishing a draft that has a future date is refused with
future_date_on_publishedunlessallow_futureis true. WordPress scheduled it without saying so. - New:
create_mediatakessha256, and refuses a file that arrives altered withchecksum_mismatch. It always returnssha256anddecoded_bytes, so a caller can compare without sending a digest. - New:
create_mediarefuses bytes that are not a whole image of the declared type withinvalid_image: PNG chunk checksums and end markers are checked, not only the header. Sizes WordPress expected but could not make are a warning rather than an empty list. Its errors are now JSON text with a code and details. - New:
media_upload_start,media_upload_chunkandmedia_upload_finishupload an image over about 3 KB in pieces, with a digest on the whole file and optionally on each piece. The result is whatcreate_mediareturns. Retrying a chunk or a finish is safe. Unfinished uploads are removed after an hour with no activity. - New:
get_custom_cssandupdate_custom_cssread and set the theme’s Additional CSS, stored exactly as sent. CSS that loads anything from another site is refused, and a person can still add that in the Customizer. Administrators only, with a WordPress user behind the credential. Rollback restores the previous CSS for the theme it was written for. - Changed: The post that holds the theme’s Additional CSS can no longer be used as a target of other write tools such as
update_postandupdate_post_meta(custom_css_target). Useupdate_custom_css. - New:
update_user_profilechanges a user’s display name, nickname, first and last name, description and website. Email, password and roles cannot be changed. The display name must be one WordPress offers for that user, or the call must set the nickname to the same value. - Fix: Changing the site title or tagline through
update_site_settingssaved the value but returned an error and no receipt on a site with Elementor, when the site key had no owner or Elementor’s kit was missing or in the trash. It now returns the receipt as usual, and rollback works the same way. - Fix: With a site key that had no owner, Elementor’s Site Settings kept the old title or tagline after such a change, and publishing Site Settings wrote it back. It now follows the change.
1.18.0
- New:
update_site_settingssets the site icon:site_icontakes a Media Library attachment ID, and 0 clears it without deleting the attachment. The image must be PNG, JPEG, GIF or WebP and square; it is not cropped, and under 512×512 it is set with a warning. The response gives before and after with ID and URL,icon_url_32andicon_url_192, andwarnings. It hasdry_runand rollback, including back to no icon, and purges the whole site. - New:
update_site_settingscreates the sizes WordPress uses for a site icon, and only those, solink rel="icon"points at a file of the right size. Sending the ID that is already set creates any that are missing, which repairs an icon set through Elementor’s Site Favicon. - New:
update_site_settingssets the theme’s logo:custom_logohas the same checks, except that it does not have to be square. WordPress keeps a logo per theme, so its rollback is refused after a theme switch. - New:
get_site_settingsreturnssite_iconandcustom_logo, each{id, url}or null. A nullurlmeans the image no longer exists. - New: When Elementor’s Site Settings has a saved favicon or logo, a change through
update_site_settingsor its rollback updates it too. Publishing Site Settings otherwise writes the old image back over the new one. - Fix: Rolling back
create_mediafor the image used as the site icon or logo is now a conflict needingforce, which deletes the image and clears the setting. It left the site pointing at an image that no longer existed.
1.17.0
- New:
create_elementor_templatecreates a template the way Add New Template does: header, footer, single post and page, archive, search results, 404, popup, section, container or page. Theme Builder types need Elementor Pro. It builds a draft, fills it, sets its conditions and publishes last, so a failure on the way leaves nothing showing. A header or footer with conditions cannot be published empty, because it would replace the theme’s with nothing. Administrators only. - New:
set_elementor_template_conditionssets where a template shows, through Elementor Pro’s own conditions manager, which rebuilds the cache that decides what renders. It returns before, after andverified, and warns when another published template may show on the same pages. The same conditions again rebuild the cache if it has gone stale. Administrators only. - New:
create_menucreates a navigation menu, optionally in a theme location, andassign_menu_locationputs a menu in a location or clears it. Rollback ofcreate_menudeletes the menu and gives the location back; a menu that has items needsforce, because deleting a menu deletes its items for good, and one given a location afterwards needs that change rolled back first. - New:
get_menuslists every location the theme registers, with the menu in it (locations). - New:
resolve_urlsays which Theme Builder header and footer a URL gets (theme_locations), by Elementor Pro’s own rules applied to that URL. A page on Elementor Canvas gets neither, and says so (hidden_by_page_template). Another host gives null, and what it cannot judge goes undernot_evaluated. - New:
list_elementor_templatesreturnsconditions_revision, forif_revision. - New: Server instructions describe the header and footer workflow, menus, and
elementor_header_footer. - Fix:
resolve_urlandget_postwithinclude_shadowingreported a header, footer, popup or section on Entire Site as what renders every page, so a request to edit a page could end up editing the site header. Only templates that replace a page’s content count now. - Fix:
resolve_urlfollows Elementor Pro’s rules for the blog, archives, the front page and author archives. A blog archive template was reported as shadowing ordinary pages. - Fix:
resolve_urldecides what kind of page a URL is from WordPress’s own rewrite rules and query, instead of guessing from its path. Later pages of the blog and of archives, pretty search URLs, custom taxonomies and plain-permalink query strings were read as not found or as the front page, and terms and authors that do not exist as archives.route_typegainstaxonomy_archive,date_archive,search_resultsandblog_homefor pages it called404. - Fix: A singular template is no longer reported as shadowing the blog index or a search.
- Fix:
update_postrefuses to publish an empty header or footer that has display conditions, which would remove the theme’s from those pages. - Fix: On a post with Elementor off,
update_postno longer says a content edit will not reach visitors. - Fix: The result of Save Settings now appears next to the button. It appeared at the top of a long page, out of sight, and a failed save looked the same as a successful one.
1.16.0
- Security: Hardened which stored data a post meta write can reach, and how a rollback treats stored data. Update recommended.
- Change: update_post_meta refuses a key the database would read as a different key already stored on the post or, for a key new to the post, as another spelling stored on the site (meta_key_mismatch). A new key with spaces or characters outside ASCII needs force. A key over 255 characters is refused (meta_key_too_long); nothing was stored before, though the response said it was.
- Fix: Changing a page’s title, status, slug or excerpt with update_post no longer removes iframes and scripts from content the call did not mention. Rolling back a post field now restores it as it was stored; the same filter used to remove them from the restored value, and rollback still reported success.
- Fix: An Elementor element tree that would crash the page for visitors, such as a JSON object or an element with no elType, is refused with elementor_invalid_tree. It used to be stored and reported as a success.
- Fix: A revision’s ID can no longer be used as a write target (revision_target). WordPress sent the change to the parent post, past the checks made on it.
- Fix: Rolling back an Elementor write on a page with no elements yet now restores the content visitors saw, also when Elementor’s flag was on.
- Fix: Rolling back “Elementor turned off” after the page was edited is now a conflict, because turning it back on would hide that edit.
- Fix: update_seo_data, and its rollback, no longer damage SEO plugin variables such as %%category%% and %%date%%, or encoded characters in a canonical URL when it is read.
- Fix: A widget that fails while rendering can no longer corrupt the response of the tool call, which lost the change_id of a write that had happened.
- Fix: A write could return a change_id that was never saved, so rollback could not find it. This happened on healthy sites when a meta key was longer than 100 characters, and when a database column was missing. Long keys now save. If an undo record really cannot be saved, the response says so, with no change_id, and Diagnostics shows it.
- Fix: Elementor writes no longer overwrite the content of a page sent “Back to WordPress Editor”. They are refused unless update_elementor_data is called with activate_builder: true, and rollback then restores the content, the setting and the old layout. get_page_builder reports these pages with elementor_tree_present.
- Fix: A new page given a layout with update_elementor_data now renders as an Elementor page.
- Fix: Rolling back an Elementor change now also updates post_content, which search and feeds read.
- Fix: A stripped style or script no longer leaves its CSS or code on the page as visible text (WordPress 6.5 or later).
- Change: The inline style block setting checks CSS more strictly. An independent review, with Chrome, found ways past the old check to load files from other sites. A style block is now dropped whole if its text names another site, including in a // comment or an attribute selector, and a url() pointing at this site needs a path.
- New: create_post, update_post, update_seo_data, assign_term, create_term, update_term and delete_term now honour dry_run. They used to ignore it and really write. A tool with no dry run now refuses the flag with dry_run_unsupported instead of running.
- Fix: delete_term no longer reports the default category as deleted when used with a key that has no owner.
- New: Diagnostics shows database table problems and undo records that could not be saved. Table problems are retried automatically.
Earlier releases
The changes in 1.15.1 and earlier are in changelog.txt.
