Table of contents

Remove an asset

If you need to remove an asset manually from, follow these steps:

  1. ssh backend-1.production
  2. govuk_app_console asset-manager
  3. 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.extension')
  4. Make a note of the path of the asset: asset.file.path - this will be used to delete the file from the file system
  5. Mark the asset as deleted (and remove it from S3 if necessary - this will prevent restoration)
  6. Remove the asset from asset-manager file system (it may not be here as these are automatically removed after S3 upload)
    1. ssh asset-master-1.production
    2. cd /mnt/uploads/asset-manager/assets
    3. Use the path identified in step 5 to check for the file by removing the /var/apps/asset-manager/uploads/assets prefix
    4. sudo rm path/to/file
  7. Add a cache bust and check that the asset responds with a 404 not found
  8. Wait 20 minutes for the cache to clear, or purge it yourself
  9. Verify that the asset is not there
  10. Request removal of the asset using the Google Search Console


You might need to look at the timestamps or other information to figure out which records to delete if two assets share the same filename.

This page was last reviewed on 27 February 2019. It needs to be reviewed again on 27 August 2019 by the page owner #govuk-2ndline .
This page was set to be reviewed before 27 August 2019 by the page owner #govuk-2ndline. This might mean the content is out of date.