Skip to content

Set the Site Icon and Logo with AI ​

Use Easy MCP AI's site settings tool to set the WordPress site icon and logo from images in your Media Library.

In this article

Check Access ​

The connected WordPress user needs the manage_options capability, and the API key or connection must allow write access to site settings. Make sure wp_update_site_settings is enabled under Easy MCP AI > Tools. This tool is off by default on new installations. If you enable it, click Save changes.

For an API key, make sure its allowed tools include wp_update_site_settings. For an OAuth connection, approve write access to Site Settings.

Ask your AI client to use wp_list_media to find an image in the Media Library, then use its attachment ID with wp_update_site_settings. An attachment ID is the number WordPress assigns to a Media Library item. Pass the ID as site_icon or site_logo—not the image URL, filename, or image data. For a site icon, WordPress recommends a square image that is at least 512 × 512 pixels.

Send 0 for either field to remove the current icon or logo. If you leave a field out of the request, its current value stays unchanged.

A classic theme must support custom logos before WordPress can set a nonzero site_logo. If the theme does not support custom logos, the tool cannot set one. Block themes display the logo through the Site Logo block.

Check the Result ​

Review the response fields:

  • updated indicates whether a setting changed. If it is false, the supplied values already match the current settings.
  • changed_fields lists the settings that changed; unchanged_fields lists settings that already had the supplied values.
  • A site icon update also returns site_icon_url.

Check the browser icon for the site icon, and view the site's logo placement to confirm the logo appears as expected.

Was this helpful?