Overwrite a document file

Article
Read time: 2 minutes

The Media Library stores documents (like forms and PDFs) used on your website. When a document needs to be updated, it's best to replace the existing file in the Media Library. This ensures the latest version appears everywhere the file is already linked - whether it's used in one place or multiple - and helps avoid broken links. Any details you’ve added - like the title or teaser - will stay the same.

  1. Log into Sitecore.
  2. Click the Media Library  icon.
  3. Navigate to the folder where the current document is stored.
  4. Click the document file to open its properties.
  5. If a yellow message bar appears, select Lock and Edit.
  6. Scroll down to the Media section and click Detach.
    Media Library - Media Section
  7. Confirmation dialog will appear - click OK.
    Detach document file dialogue box
  8. Then, click Attach.
    • In the popup window, click Choose File to browse for the updated document.
      Attach document file dialogue box
    • Once selected, click Attach to upload it.
  9. Click the Save  icon to save your changes.
  10. Click the Edit  icon and select  Check In to finish.

The document file has now been replaced. Any pages that link to this file will now display the updated version, and existing document properties will remain unchanged.

WARNING: Publish the Updated File

To make the updated version visible on the live website, the file must be published.

Media Library
Top