Skip to main content
Table of contents


Replace an asset's file

Note: This will not apply to any file that has not already been uploaded. If you're trying to upload a large file for a client, upload a small one first then replace with the below steps. If you're trying to fix a file that is stuck uploading in Whitehall, look here.

If you need to replace the file of an existing attachment without changing the URL, follow these steps:

  1. Copy the new file from your computer to a backend server:

     gds govuk connect scp-push -e <environment> aws/backend:1 filename.ext /tmp
  2. Get an app console on that same server:

     gds govuk connect ssh -e <environment> aws/backend:1
     govuk_app_console asset-manager
  3. Find the asset:

     asset = Asset.find("asset-id-from-url")` # e.g. `57a9c52b40f0b608a700000a`
     # or for a Whitehall asset:
     asset = WhitehallAsset.find_by(legacy_url_path: '/government/uploads/system/uploads/attachment_data/file/id/path.ext')`
  4. Check the asset is what you think it is.

  5. Replace the file:

     asset.file ="/tmp/filename.ext").open!
This page was last reviewed on 18 September 2020. It needs to be reviewed again on 18 March 2021 by the page owner #govuk-2ndline .
This page was set to be reviewed before 18 March 2021 by the page owner #govuk-2ndline. This might mean the content is out of date.