wp_update_media_item tool reference for media workflows
Writeupdates attachment metadata such as title, content, and excerpt.
Description
updates attachment metadata such as title, content, and excerpt.
What it is for
- Improving titles, captions, descriptions, and alt text.
Example use case
improving accessibility metadata.
Sample prompt
Update media item ID 981 with a clearer title, caption, and descriptive alt text for accessibility.
Sample response
{
"tool": "wp_update_media_item",
"status": "ok",
"updated": true
}
What does wp_update_media_item do?
updates attachment metadata such as title, content, and excerpt.
Does wp_update_media_item modify the media library?
Yes. It can create, update, or delete media assets depending on the arguments.
Which capability is commonly required?
It usually runs under controls compatible with upload_files and the active MCP profile.
How should wp_update_media_item be used safely?
Confirm target assets, review uploads before publication, and keep rollback-friendly workflows where possible.
What dependency should be confirmed first?
WordPress media library