Image reference update behavior
The improve-image and remove-background tools can create a new Media Library attachment and update supported references on the current site. The original attachment is retained after both successful and interrupted updates.
Successful operation
- The tool validates access to every selected image before requesting generation.
- It imports the generated image and copies the original title, alternative text, caption and description when reference updates are selected.
- It saves a resumable reference update and processes supported URL and path variants in bounded batches.
- It updates affected WordPress cache entries and supported POM Framework settings.
- The screen reports success after the saved update finishes.
Content, excerpts, post and term custom fields, term descriptions, widgets, theme modifications and POM Framework settings are supported. Serialized arrays can be updated; serialized objects are preserved. Values larger than 2 MiB and settings directories with more than 1,000 entries are outside the supported automatic-update limits. Attachment IDs, unrelated plugin options, custom tables, external references and other sites are not rewritten.
Permissions
Updating site-wide references requires manage_options or pom_ai_manage_media_references, plus permission to edit both image attachments. Pomatio Platform supplies the dedicated capability to Editors and Shop managers. WordPress content permissions continue to control the underlying images, and each resumed operation checks the current permissions again.
Recovery
A saved update reuses its existing replacement image. Resume image reference updates continues the saved work without another AI generation request. WordPress scheduled tasks can also advance it when cron runs. One image cannot have competing updates owned by different users.
Stop pending reference updates stops future batches and preserves both attachments and all changes already applied. Completed updates can be acknowledged again after a lost browser response. This is recovery, not a reverse-change log.
If import succeeds but the reference update could not be saved at all, the error says that the new image exists but its references could not be updated. Review the two Media Library entries before requesting another generation. If an import cannot produce a usable attachment URL, the failed new attachment is removed while the original is kept.
Related: reference coverage, update or copy, and recovery.