Assets

Uploading assets

There are two methods of getting an asset into Amplience. One way 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 upload those assets straight into Amplience.

The other method of uploading assets is manually using the Content Hub app. To manually upload assets, optionally, navigate to the folder to which you want to upload, then click the Upload Assets button. From the upload dialog use your preferred method for uploading your files:

  • Select files from your file system, by clicking anywhere in the upload area
  • Drag files into the upload area
  • Upload files directly via a URL, by clicking the Link URL item
  • Use the file upload services and social media apps available to you, for example, Instagram, Google Drive, DropBox, by clicking the relevant icon

The upload dialog is shown in the image below.

The upload dialog
The upload dialog

Considerations for duplicate filenames

Each asset within an asset store must have a unique name across all folders which ensures the asset has a unique Dynamic URL. 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
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
Example showing new asset name with appended number

Reserved and unsafe characters in filenames

The following characters must not be included anywhere in a filename of a file uploaded into Content Hub. Including one of these characters in a filename will lead to problems when uploading 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 uploading into Content Hub or rename the uploaded asset.

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

Publishing assets

For each asset, you'll see an icon in the top left shows what type of media it is and, if it has been published, a green cloud icon. If the icon has not been published this icon is not displayed.

The up arrow in a cloud icon in the area below an asset is used 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. We also use this to republish existing assets that have been updated.

The image below shows an image asset in the process of being published.

A video asset being published
A video asset being published

When the asset is published, the green cloud icon is displayed. If the cloud is marked with a tick, it indicates that the latest version of the asset is published.

The image has been published
The image has been published

If you make a change to a published asset, such as replacing it with an asset of the same name, or restoring from a previous version, then the asset will require republishing and the cloud icon will be shown without a tick.

If you make a change to a published asset, the publish icon indicates that the asset requires republishing
If you make a change to a published asset, the publish icon indicates that the asset requires republishing

Assets can also be published from the 'Publish' item in an asset's menu or from the properties pane. If multiple assets are selected, then each of these items will be published.

Asset Properties

When you click on the properties icon in the area underneath an asset it will open the properties screen. You'll see that a published asset has a dynamic URL, which indicates its published to the CDN and available to be consumed from this URL and manipulated using dynamic media. For an unpublished asset, no URL will be shown.

In the properties pane you'll also see asset name, label, published status and the file size, width and height of the asset.

The asset properties pane
The asset properties pane

At the top you'll see a tab called metadata. This is where all the generic metadata is displayed for an asset, together with any custom metadata, such as product information that you have added. Point of Interest makes use of metadata to store hotspots and focal points.

The Asset contextual menu

The contextual menu, available by clicking on the cog menu or by right clicking an asset, includes a set of actions that users can perform on an asset. This includes preview, publish, create media set and edit with point of interest. It also allows you to set workflow status.

The asset contextual menu
The asset contextual menu

With multiple assets selected, the items shown in the contextual menu will reflect the selection.

Previewing an asset

You can preview an asset using the eye icon. This will display the asset in a pane on the right hand from where you can make the image larger and zoom in and zoom out on particular areas of the image.

Previewing an image
Previewing an image

Preview is only available for particular asset types, including images, video, sets, PDFs and animated GIFs. For assets where a preview is not available, the eye icon will not be shown.

Renaming an asset

You can rename assets and also set the item's label, which can be different to the asset name. To rename an asset, choose "Rename" from the asset's contextual menu.

To rename an asset, choose Rename from its contexual menu
To rename an asset, choose Rename from its contexual menu

The rename feature is also available from the asset properties pane. Click the pencil icon to the right of the name or label to open the rename dialog.

You can also rename an item via its properties pane
You can also rename an item via its properties pane

In the example below the name of a published asset is being changed from "signature-image" to "signature-hat". Note that the asset name must be unique within your account.

When you upload an asset to Content Hub, the label will be set to the asset name, but you can change it to a more friendly name to help you identify the asset. The label will be displayed below the asset in the gallery. In the example the asset's label is also updated to "our signature hat".

When you choose to rename a published asset it will also be republished for you with its new name. Click "Save & Publish" to change the name and label and to republish the asset. You can also rename an asset that has not yet been published.

You can enter a new name and label
You can enter a new name and label

The asset will now be available at your image URL with its new name, for example https://cdn.media.amplience.net/i/ampproduct/signature-hat.

The asset is published with its new name
The asset is published with its new name

When renaming an asset you should not include the file extension (for example ".jpg" or ".png") in the name field.

Workflow

For each asset you can set a workflow status by selecting the 'Set workflow status' item from the menu. From the workflow status window you can select whether an asset is draft, archived, in review or approved or to assign the asset to another user within the account. When you change the workflow status this will be reflected in the asset properties pane.

Setting asset workflow status
Setting asset workflow status

Note: The workflow status is not enforced and is intended to support an existing workflow rather than imposing a new one, as well as to make assets easier to organise. Workflow status is independent of the publish status and assets can be published irrespective of the workflow status, or whether one is set.

Media share