Skip to main content
Table of contents


Upload an asset to asset-manager

Some publishing apps such as Mainstream Publisher do not provide the facility for editors to upload assets such as images and PDFs. In these rare cases, we can upload assets to asset-manager manually and give the URL to content editors to embed.

Production assets are replicated to staging and integration nightly, so it is best to simply perform the upload directly in production. First, upload the asset to a backend machine:

scp my_file.jpg backend-1.backend.production:/tmp/

Then SSH to the same machine and run the upload command:

ssh backend-1.backend.production
cd /var/apps/asset-manager
sudo -u deploy govuk_setenv asset-manager bin/create_asset /tmp/my_file.jpg

Note the basepath the script outputs. This should be appended to the asset host, for example:
This page was last reviewed on 3 December 2019. It needs to be reviewed again on 3 June 2020 by the page owner #govuk-2ndline .
This page was set to be reviewed before 3 June 2020 by the page owner #govuk-2ndline. This might mean the content is out of date.