Skip to main content

Uploading assets

Assets can be uploaded into Amplience using various methods. Generally, bulk upload is used to upload assets in volume, while the Dynamic Content and Content Hub apps provide a convenient way for you to upload assets as you need them. For example, a content producer may want to upload a few files to complete a piece of content.

Upload methodDescription
Bulk uploadAutomated upload for large volumes of assets, use the Bulk upload (FTP) tool or the GraphQL Asset Management API.
Dynamic Content Assets tabUpload up to 30 assets at a time through the Dynamic Content Assets tab.
Content Hub appUpload up to 200 assets at a time using the Content Hub app.
uploading with the graphql asset management api

You can also use the GraphQL Asset Management API to upload assets. Note, this method doesn't transcode video files.

Uploaded files must have supported file types to be publishable, and therefore usable within the Amplience platform. See supported file types.

Bulk upload
Link copied!

Automated bulk upload is how most assets are ingested into Amplience. We use the term "ingested" because the bulk upload process involves more than simply uploading files. During bulk upload automated scripts can be applied to format the uploaded files.

The bulk upload method is to upload files to an SFTP location using any standard SFTP client, connect this to Amplience via upload connectors and set up a bulk upload. The bulk upload is usually set to run every hour and will ingest those assets straight into Amplience.

For information about processing jobs and bulk upload, see Content Hub tools.

developer note:

A key difference between uploading with the FTP Bulk upload and the GraphQL Asset Management API is that the API doesn't transcode video files, so you must do this separately. See Uploading video to Content Hub.

Uploading assets with Content Hub
Link copied!

To ingest assets manually using the Content Hub UI, you click the Upload button and drag files into the upload area in the dialog or choose a file from your file system. You can also upload files directly via a URL or via one of the file upload services, including Google Drive, DropBox and Box.

The Content Hub Upload dialog is shown in the image below.

The Content Hub asset upload dialog

Uploading assets with Dynamic Content
Link copied!

The Dynamic Content Assets tab streamlines your content production workflow by allowing you to quickly perform some key asset management tasks without the need to switch to Content hub. A key advantage of using this upload method is that you can publish on upload.

If the Assets tab isn't displayed in your environment, see managing the assets tab for details of how to request access.

The Assets tab allows you to manually upload up to 30 assets at a time to the Asset Library.

To manually upload assets using the Assets tab, navigate to the folder to which you want to upload, then do one of the following:

  • Drag and drop files from your file system into the folder asset area, as shown below.

Uploading using drag and drop

  • Click the Upload Assets button. Your system's default file chooser dialog is opened, from which you can choose the files you want to upload, as shown below.

Uploading using the upload dialog

You must choose a folder, or an asset store in order to upload assets. If no asset store is selected and you drag files into the asset window then a warning message is displayed, as shown below:

Assets may not be uploaded to the All assets section

The upload progress is displayed.

A progress bar is displayed while assets are being uploaded.

When the upload is complete, a notification confirms the number of assets uploaded and provides you with the option of publishing the assets.

The order in which assets are arranged on the Assets tab is based on the modified date, starting with the most recent modified date.

When you upload assets using the assets tab, the same validation is performed as when you upload via Content Hub. For information about supported file types, maximum file sizes and other validation, see Content Hub FAQs.

Publishing assets
Link copied!

Using the Assets tab you can publish up to 30 assets at a time.

Use the up arrow in a cloud icon (displayed bottom left of asset cards), to publish an asset. If you click the publish icon for an asset that has not been published, the asset will then be published and a URL will be generated for it. You can also use this to republish existing assets that have been updated.

The publish icon

To publish all of the assets visible to you on the assets page, check the Select all checkbox (at the top left of the page), then click the publish icon which becomes available at the top right of the page.

Choosing to Select all

Tip: If you want to publish most of the assets on the assets tab, use the Select all method above and then deselect the items that you don't want to publish.

Publish status icons
Link copied!

For each published asset on the assets tab, you'll see a green cloud icon containing a green tick. If the asset has not yet been published this icon is not displayed. If it's not possible to publish the asset, for example because it requires a transcoding profile, an orange cloud icon containing and exclamation mark is shown.

The image below has no icon, and therefore shows that the asset is unpublished:

Example of an unpublished asset

The green cloud icon in the image card below shows that the asset is published:

Example of a published asset

The orange cloud icon in the image card shows that an attempt to publish the asset has been unsuccessful.

Example of an asset that can't be published from the assets tab

The published icon

Once an asset has been published, the publish status icon always shows the green cloud with a tick, whether it is the latest version or not. For more information see the Limitations section at the end of this page.

Publishing on upload
Link copied!

Publish on upload is a feature that saves you time by streamlining two separate processes - upload and publish. Following upload you have the option to immediately publish assets.

The message below is displayed, from which you simply choose Publish:

Upload notification

Once publishing is completed, the publish status icon on the uploaded assets will change to a green tick. If any of the uploaded files cannot be published then the publish status of these assets will change to an orange exclamation mark to indicate that the publish was unsuccessful.

In the example shown in the image below, two images were published on upload, but publishing the video failed. Videos cannot be published on upload because they require a transcoding profile which must be added in Content Hub.

Videos cannot be published on upload.

Asset types that can't be published from the assets tab
Link copied!

The following asset types cannot be published from the assets tab and so cannot be published using the publish on upload feature:

  • Video files. You will need to apply one or more video transcoding profiles to a video before it can be published. This must be done in Content Hub, as explained on the working with video page. When a video transcoding profile has been added to a video it can be published, either from the assets tab or using Content Hub.

  • Unsupported asset types. The asset type must be supported by Content Hub in order to be published. See the Content Hub FAQs for the list of asset types supported by Content Hub.

Searching for assets
Link copied!

The search feature in the assets tab enables you to quickly find the assets you want, rather than browsing through the library. For example, entering red into the search box finds all assets with that string in the asset name. The search is not case sensitive.

Note, in addition to the asset label that is displayed on the screen, the search considers other text associated with an asset. This means you may see assets in the search results whose labels don’t match your search text. You can see all the fields and associated text for each asset in Content Hub.

The image below shows an example of searching for red.

Searching for assets with names containing red

You can refine your searches using AND, OR and NOT. In the example below we have searched for assets that contain red or blue in the name:

Searching for assets with names containing red or blue

Note that the search is performed on assets within the current folder only.

Considerations for duplicate filenames
Link copied!

Each asset within an asset store must have a unique name across all folders. This means you cannot upload a file with same name as an existing file, even to a different folder. For example, if you already have an asset named 'basic-white-tee-shirt' in the Men folder, you are not permitted to upload another file named 'basic-white-tee-shirt' to a different folder, for example 'Women'.

If you do attempt to manually upload a file with a duplicate name, you are given the option of overwriting the existing asset or creating a new asset in Content Hub.

An example of the duplicate filename message is shown in the image below.

The duplicate filename message

If you choose the "rename new" option, a new asset is created with a name formed from the original filename with a number appended, as shown in the image below.

Example showing new asset name with appended number

Note that it is possible to have a file with the same name in different asset stores. In this case the most recently published asset will be retrieved from the asset's URL.

When working with unpublished assets with the same name in different asset stores, the order in which assets are retrieved is determined by the virtual staging environment content selection rules.

Reserved and unsafe characters in filenames
Link copied!


The following characters must not be included anywhere in a filename of a file to be ingested into Amplience. Including one of these characters in a filename will lead to problems when ingesting the file, or retrieving the file using Dynamic Media. If you need to work with a file containing one of the characters shown below, rename it locally before ingesting the file or rename the ingested asset.

blank spaces # < > $ + % > ! ` & * ‘ | { ? “ = } / : . \ @

Working with video