Replace lets you swap the file behind an existing asset without changing its URL. This is the right tool when a logo, banner or figure has been updated and it is already used in pages, blocks or theme settings.
How it works
Omeka S serves each asset from a URL built from its storage ID, for example /files/asset/a1b2c3d4.jpg. Replace overwrites the file at that storage ID, so:
- the canonical URL stays exactly the same,
- every page, block and theme setting that references the asset shows the new file, and
- the asset's name, alt text and folder are untouched.
Nothing needs to be re-linked.
Replacing a file
- Open the asset in the library and click Replace file (same extension) in the detail drawer.
- Choose the new file.
- The drawer refreshes with the new file once the upload completes.
Replacing requires the editor role or higher.
The same-extension rule
The new file must have the same extension as the original. Uploading a .png to replace a .jpg is rejected with an error message.
The URL includes the extension, so allowing a change would break existing references. To change the format of an image, upload it as a new asset and update the places that use it.
Caching
Because the URL does not change, browsers and CDNs may keep showing the old file until their cache expires. If you need to see the change immediately, reload the page with the cache bypassed (Shift+Reload in most browsers) or purge the URL from your CDN.