wp_update_media
Updates metadata for an existing WordPress media item, such as title, alt text, caption, or description. Only the fields you specify are changed, so existing media details stay intact.
Instructions
Update media item metadata (title, alt text, caption, description, attachment, ...); only the given fields change
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"site": "<site>",
"id": "<id>"
},
"name": "wp_update_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Media ID | |
| date | No | Date in the site timezone (ISO8601) | |
| meta | No | Registered meta fields (show_in_rest) as key/value | |
| post | No | ID of the post the item is attached to (0 = unattached) | |
| site | Yes | Site id (see list_sites) | |
| slug | No | URL slug | |
| title | No | Title | |
| author | No | Author user ID | |
| status | No | Status (media normally inherits its parent's; 'private' hides it) | |
| caption | No | Caption | |
| alt_text | No | Alt text for images | |
| date_gmt | No | Date in GMT (ISO8601) | |
| template | No | Theme template file for the attachment page | |
| description | No | Description | |
| ping_status | No | Whether pingbacks/trackbacks are open | |
| comment_status | No | Whether comments are open | |
| featured_media | No | Cover image media ID (audio/video) |