Replacing or deleting a media asset

Replace media when a page needs a new image, video, or download. Delete a library asset only after you have checked that its files and links are no longer needed.

Removing a file from a page and deleting it from the shared library are different actions. A page can stop using an asset while other pages, emails, or external links still depend on it. Uploading a new file—even with the same filename—does not automatically replace those uses.

Choose the right kind of change

Use the smallest change that achieves the result:

• Show a different image or video on one page: select the replacement in that page's media block. Keep the previous library asset if it is used elsewhere.
• Change the framing on one page: adjust the block's fit, aspect ratio, or focal point. This avoids editing the shared image itself.
• Update a download: upload the new file, then change each intended link to its new delivery URL.
• Crop, rotate, resize, or adjust the shared image: use Edit image in Media. Review every place that uses the asset afterward.
• Remove a file that is no longer needed: check usage and external links, retain any copy you need, then delete it from the library.

You need permission to edit media for library changes, and permission to edit or publish the relevant content for page changes. If controls are unavailable, see Why can’t I see or edit a feature?.

Check where the existing asset is used

Before replacing or deleting a shared asset:

1. Open Site → Media and find the file by name. Open its details.
2. Confirm the filename, preview, dimensions or file type, and size. Similar names do not prove that two files are interchangeable.
3. Read Used on and note the listed entries and roles. Published entries may have a link you can open to inspect their use.
4. Check uses outside that list: page blocks and backgrounds, manually pasted URLs, shared layouts, branding, emails, and external websites.
5. Keep a copy of the current file if you may need it again. Use the Original download control under Delivery URL, or Download original in the detail page's Media actions menu.
6. Record the pages and links that must change before you remove anything.

Used on is a list of tracked references, not a complete search of everywhere the file might appear. Its total can exceed the entries shown. “Not used on any page yet” does not prove that a pasted link or external use is absent.

If usage cannot be loaded, stop the deletion check and try again after resolving the error. If Cedros reports a reference you cannot identify, ask your site administrator to investigate.

Check published pages as well as drafts. A draft that selects the replacement does not establish that the live page has stopped using the old file. Earlier content revisions may also refer to an asset you would need when restoring them.

For documents, audio, and fonts, use a saved asset-detail bookmark when they do not appear in the image/video library browser. See Uploading and organizing media.

Replace an image or video on a page

Upload the new file first and wait for it to be ready. Give it a recognizable version name so you can distinguish it from the previous asset. Follow the upload guide for supported files, processing, and descriptions.

For a Media Content block in Visual Builder:

1. Open the page and select its existing media block.
2. Under Media, use Browse library or Search library to choose the replacement image or video.
3. Confirm that the block shows the intended asset.
4. Review Alt Text, Caption, fit, crop, and focal point. Text and framing that suited the old image may no longer be correct.
5. For video, check the poster and playback controls, then test playback.
6. Open Preview and check desktop and mobile layouts.
7. Save or publish using that page's release workflow, then open the public page and verify the replacement.

For a new draft, use Save draft, review it, then Publish. On an already-published visual page, Save publishes the changes, so review before saving. See Creating and publishing a website page.

To remove the block's selected media without deleting its library file, use Clear link. Preview the resulting empty block or remove the block itself if it is no longer useful.

A cover image, section background, or shared layout uses its own media control. Change that specific placement rather than assuming the normal media block controls every image on the page. Shared-layout changes can affect multiple pages; see Reusing a shared layout across pages.

Keep the old asset until every intended live placement has been checked.

Replace a downloadable file

For an updated price sheet, brochure, or other download:

1. Upload the new version and open Edit details from the completed upload.
2. Confirm the correct file opens and retain its admin detail-page bookmark.
3. Use Copy URL to copy the new delivery address.
4. Edit each intended button or text link and replace its destination. Update the visible title, date, format, or size where necessary.
5. Preview and publish the affected content.
6. Test the download from the live page as the intended visitor.

For a page button, select its Buttons Content block and update the button's Link. See Adding images, videos, and downloads to a page for placement instructions.

A link pasted into an already-sent email or another website keeps its old address. Uploading the new file does not redirect it. Keep the old file available if that remains appropriate, or arrange a link update with the owner of that destination before deleting it.

Review the new file's Access separately. A replacement upload does not automatically inherit the old asset's restrictions. Test public downloads signed out; test restricted downloads through the intended authorized customer journey.

For future revisions, consider sharing a stable page that contains the download button. You can update that page's destination without changing the page address people have bookmarked.

Edit a shared library image

Use this path when you intend to change the library image itself. It is not a page-specific crop.

1. Open the image in Site → Media.
2. Review Used on and retain a downloaded copy of the current file.
3. Select Edit image.
4. Adjust the crop, rotation, flip, resize, color, or effects as needed. Use Hold to compare to compare pending changes with the current image.
5. Use Undo, Redo, or Reset while reviewing. Choose Cancel to leave without saving pending edits.
6. Select Save & Close when ready. Wait for processing to finish and inspect the updated asset and generated outputs.
7. Check every important public placement and any manually pasted file links.

Save changes the existing shared asset; it does not create a separately selectable copy. Content that resolves that asset can show the updated result without a separate page edit. Previously copied delivery URLs may still point to earlier outputs, so do not assume all links will change together. Recopy the current URL where a manually linked destination needs the edited file.

Undo and Reset are editing controls, not a saved-version recovery system. If you need both versions, download the current file, upload it as a separate asset, and edit that copy. Select the new copy only in the places that should change.

The file labeled Original is the current original output for that asset. After a saved edit, do not assume downloading it retrieves the first file you ever uploaded. Keep the earlier copy yourself.

If saving or processing fails, inspect the asset's actual state before trying another edit. A save can start background processing; closing the editor does not mean all outputs have finished.

Delete an unused library asset

Deletion cannot be undone through the media library. It removes the asset and its generated outputs from library use. Keep any required source copy before proceeding.

After completing the usage check:

1. Finish replacing or removing all intended references, publish those changes, and verify the live result.
2. Reopen the old asset and check Used on again. Check your separate list of pasted and external links.
3. Choose Back to Library.
4. Open Media actions—the three-dot menu—on the exact file's tile or row, then select Delete.
5. Read Delete this media? and confirm that it names the correct file. Choose Cancel if anything is uncertain.
6. Select Delete media only when the file is no longer needed.
7. Wait for completion, confirm the asset is absent from the library, and recheck affected public pages and downloads.

The server rejects deletion when it finds a protected reference. A Delete menu item being available is not a guarantee that deletion will succeed or that every untracked use is safe to remove.

Deletion is normally started from the library row menu. Some embedded media views also offer Delete in their detail controls. If a document or other asset is not listed in the image/video browser and its detail view has no deletion action, ask an administrator to remove the exact asset after the same checks. Do not remove unrelated files while trying to reach it.

Deleting a library entry does not recall copies someone has downloaded or guarantee immediate removal from browser caches or other file hosts. If you are removing a mistakenly public private file, also involve your administrator to check its access and delivery locations.

Delete several files carefully

Use bulk deletion only for a small set you have already reviewed.

Select the file checkboxes in the library, check the selected count, then use Delete with that count. Review the confirmation before choosing its final delete action. Search, filter, or page changes can change the selection, so verify it again after navigating.

Bulk deletion can partly succeed: some files may be removed before another deletion fails. Read the result, close the dialog, refresh the library, and review the remaining files before making a new selection. Do not assume an error restored items that were already deleted.

Recover from a mistake or a blocked change

The replacement looks wrong. If the previous asset still exists, select it again in the affected page, review the descriptions and layout, and use the page's normal save/publish workflow. Check the public page afterward.

A shared image edit changed other pages. Use the earlier copy you retained to create a replacement asset, then update the affected placements. Do not rely on Reset to undo a previously saved edit.

Delete fails or the file is still referenced. Open its details, inspect Used on, and check covers, galleries, attachments, and other configured uses. Some references can be retained by saved designs or history even when the file is not visible on a current page. Ask an administrator to investigate rather than deleting unrelated content or historical records.

Some files disappeared after a bulk error. Refresh and check which ones remain. Successful deletions are not rolled back when a later item fails.

A deleted file is needed again. Re-upload a retained source copy, then update the affected references and links to the new asset. The same filename does not restore the deleted asset's identity or old URLs. A page revision by itself does not restore a missing library file.

A customer still sees the old version or a broken link. Check the published page and its actual selected asset or link destination, allow processing to complete, and test in a fresh browser session. For a manual URL, copy the current delivery address and update the destination if needed.

If you need help, contact support with the filename, asset-detail link, affected page addresses, exact error, and whether you changed a page selection, saved an image edit, or attempted deletion. Keep private file links in the agreed support channel.