How to Fix Images That Are Missing After Publishing

You published or pushed a document to WordPress, the text landed fine, but one or more images show as broken or missing on the live page. Work through the checks below in order until the image reappears.

1. Confirm the image is actually in the document

Open the document in Workover and look at the image where it sits in the body. If it is broken there too, the problem is with the image itself, not with publishing, and pushing again will not fix it. Remove it and add it again before continuing.

2. Push the document again

Images are uploaded into the connected site’s WordPress media library at the moment you publish or push, not continuously. If you added an image after the last time you sent this document to WordPress, that image will not exist on the live post until you push again.

Open the document’s WordPress panel and use Push to WordPress (or Publish, if the document has never been linked to a post). This re-sends the body and uploads any image that is not yet in the site’s media library.

3. Check the permissions of the connected WordPress account

Uploading an image to the media library needs an account that is allowed to upload files. If the WordPress user behind the connection is a Contributor, WordPress will accept the post text but refuse the image upload, and the image is left pointing back at Workover instead of the site.

In WordPress, check the role of the user Workover is connected as. It needs to be Author or higher. If you change it, push the document again so the image upload is retried.

4. Replace images that point at an outside URL instead of a file you added

If an image was inserted as a link to a picture hosted somewhere else, rather than dragged in, pasted in as a file, or added from the / menu, Workover leaves that link exactly as it is when it publishes. It does not copy that image into the site’s media library.

If the original source later becomes unreachable, requires a login, or blocks other sites from showing it, the image will be broken on your live page even though the document looks fine. Delete the image from the document and re-add it by dragging the actual picture in or uploading the file, then push again.

5. Re-add images that were later deleted from the WordPress media library

Once an image has been pushed to a site, Workover remembers the media library file it used and reuses it on later pushes instead of uploading a duplicate. If someone deletes that file from the WordPress media library afterwards, Workover has no way to know, and the live post keeps pointing at a file that no longer exists.

To fix this, remove the image from the document and add it again (upload it fresh rather than reusing the same one). Workover treats it as a new image and uploads a new copy the next time you push.

6. Check the image file itself

Workover accepts JPG, PNG, GIF, and WebP images. If an image reached the document some other way (for example a pasted link to a file in a different format, such as SVG), the site may accept the post but reject that particular file when Workover tries to move it into the media library.

Re-export or convert the image to one of the supported formats, add it to the document as a file, and push again.

Still broken?

If the image still does not appear after working through these steps, check whether the site itself is reachable and the connection is still valid: a connection that has expired or lost its credentials will fail the same way for every image on every future push, not just this one.