Managing assets on the Media page

This article explains where assets live in Prepr and which actions you can perform on them.

Introduction

You can find all your digital assets in one place in Prepr using the Media page. This makes it easy to access, view, and manage your assets.

Developer note
With the Prepr assets mutation API, you can upload, update, and delete assets in batches, or apply image transformation options.

You can directly upload, edit, download, replace, delete, organize, and find assets from the Media page. For Mux videos, you can also replace thumbnails and add subtitles. Let's dive into each of these actions in more detail.

Uploading assets

To upload an asset, follow the steps below.

  1. Simply drag and drop the asset/s directly from your local drive.

Drag asset

  1. Or at the top of the Media page, click the Upload asset button to open your file explorer.

  2. Choose the asset/s you want to upload and click the open button.

You'll see the progress of asset/s in each thumbnail while they're uploading.

Upload an asset

You can then click the thumbnail of the assets you want to view.

You can also upload an asset directly in your content item. Check out the configuring assets doc for more details.

Editing assets

To edit a specific asset, go to the Media tab and click the thumbnail of the asset to open it.

You can update some of the asset fields below directly in the Asset page.

Asset details

  • Internal name - This field is required and is used to enter the Title of the asset.
  • Description - This optional field is used by editors to describe the asset.
  • Author - This optional field can be used to enter the name of the photographer or the visual designer of the asset.
  • Additional fields - Any additional fields can be added to the Asset model, such as Copyright info. When localization is enabled in the Asset field, a field will be available for each locale allowed in your environment. For more details, check out the Asset model doc.
  • Tags – Allows you to add one or more tags to an asset.
  • Collections – Allows you to group assets into collections.
  • Used in - The list of all content items that use this asset.

To edit the asset details, simply update the applicable fields and click the Save and close button.

The Description field is recommended for internal use. To describe your assets in a web application, use the Caption feature.

Developer note If you want to add information from the Description field to your web application, refer to the GraphQL API reference.

In the sidebar of the Asset page, you can see the following generated data:

  • Optimized URL – The URL you can use to include the asset in your front end.
  • Download URL – The URL you can use to download an original asset file.
  • Asset ID – The unique identifier of an asset you can refer to in API requests.
  • Playback ID – The public Mux Playback ID for videos.
  • Metadata – The date and time when an asset is created and changed.

Downloading an asset

In the Asset page, you can download this asset to your local storage, by clicking the Download button in the sidebar.

Dowload an asset

The original file will be saved to your default download folder.

Replacing an asset

In the Asset page, you can replace an existing file with a new one by clicking the Replace button to choose the replacement file from your local storage.

Replace an asset

You can only replace an asset with the same file type — for example, images with images, videos with other videos, and so on.

Deleting assets

In the Asset page, you can delete an individual asset if you no longer need it, by simply clicking the Delete button.

Delete an asset

In the confirmation dialog window, click the Yes, delete button to confirm the delete.

You'll get a warning if the asset you want to delete is being used in any content items. If you continue with the delete action anyway, note that you can cause broken web pages. Once you delete an asset, the action cannot be undone.

You can also delete multiple assets by following the steps below.

  1. Go to the Media tab and select assets by hovering over each thumbnail and clicking the icon. To select all assets, click the icon in the top action menu.

  2. In the top action menu, click the icon to delete the selected assets.

delete multiple assets

  1. In the confirmation dialog window, click the Yes, delete button.

You need special permissions to delete multiple assets at a time. To get this access, request the Prepr administrator to link your profile to a user role with the Allow bulk update content items and assets permission in your environment.

Organizing assets

In Prepr, you can organize your assets in a way that works for you. For example, choose to group assets into collections, add tags, or do both for better categorization and precise search. Find out more below.

Collections

A Collection represents a set of media files grouped by specific attributes and includes all types of assets. It can be a collection of profile pictures, banners, stock photos, etc. Let's look at how to organize assets using collections in more detail.

Create a collection

To create a collection, follow the steps below.

  1. Go to the Media tab.

  2. In the top action menu, click + Add collection.

  3. Enter the title for a collection and click Add to confirm.

Add a collection

Add assets to a collection

Once the collection is created, you can add multiple assets to your collection using one of the steps below.

  1. Go to the Media tab and select assets by hovering over each thumbnail and clicking the icon. To select all assets, click the icon in the top action menu. And click the icon.

Add multiple assets to a collection

  1. Or, click the collection folder to open the collection and click the Add assets button. In the dialog window, you can then select existing assets you want to add to the collection or click the Upload assets button to upload a new asset to add to the collection.

To add a single asset to a collection, follow the steps below.

  1. Go to the Media tab and click the thumbnail of an asset to open it.

  2. At the bottom of the Asset page, click the + Add to collection link in the Collections section.

  3. Choose a collection from the drop-down menu.

  4. On the right-hand sidebar, click Save and close to apply the changes.

Remove assets from a collection

You can remove multiple assets from a collection in the Collection page or a single asset in the Asset page.

To remove several assets from a collection, follow the steps below.

  1. Go to the Media tab and click the collection folder to open the Collection page.

  2. Select the assets you want to remove by hovering and clicking the icon on each of the thumbnails.

  3. Click the icon in the top action bar to remove the assets from this collection.

Remove multiple assets from a collection

To remove a single asset from a collection, follow the steps below.

  1. Go to the Media tab and click the asset to open it.

  2. On the Asset page, go to the Collections section and hover over the collection.

  3. Click the icon to remove the asset from the collection.

  4. On the right-hand sidebar, click Save and close to apply the changes.

Set a collection cover

A collection cover gives you a first impression of the assets in a collection. The first added asset is the collection cover by default. To change the cover, first click the collection folder at the top of the Media page to open it. Hover over the thumbnail of an asset and click the Set as cover link.

Set a collection cover

Update a collection title

To update a collection title, first click the collection folder at the top of the Media page to open it. Then, click the name of the collection to edit the Title or click the icon and choose the Edit collection option. In the dialog window, enter a new title and click the Save button.

Delete a collection

To delete a collection title, first click the collection folder at the top of the Media page to open it. Then, click the icon and choose the Delete collection option. In the confirmation window, click the Yes, delete button.

When you delete a collection, the assets are removed from the collection, but not deleted.

Tags

A Tag is a meaningful label you can assign to your assets to differentiate between them while filtering. You can add tags to multiple assets or to a single asset in the Asset page.

To tag several assets at once, follow the steps below.

  1. Go to the Media tab and select assets by hovering over each thumbnail and clicking the icon.

  2. In the top action menu, click the icon.

  3. Choose an existing tag or type a new one.

  4. Click the Add tags button.

Tag multiple assets

To tag a single asset, follow the steps below.

  1. Go to the Media tab and click the asset to open it.

  2. At the bottom of the Asset page, click the Tag field.

  3. Choose an existing tag or type a new one.

  4. On the right-hand sidebar, click the Save and close button to apply the changes.

That’s it. You have organized your assets in the Media Library. Now it's easier to find the right one. Let's see how to do this in the next paragraph.

Finding assets

Prepr gives you multiple search and filter options to find the assets you need with ease:

  • Search the assets by the asset title or keywords in the asset description.
  • Filter the assets by Asset type, Tags, Created on date, or the Unused checkbox.
  • You can also filter assets by enumeration field values in the Asset model, for example, to find a specific license holder.

Filter and search assets

Replacing video thumbnails

By default, a thumbnail image is taken from the middle of the video based on the Mux Playback ID. Still, you can set a custom video thumbnail in Prepr as follows:

  1. Go to the Media tab and click the thumbnail of the video asset that you want to edit.
  2. On the Asset page, hover over the thumbnail and click the icon.
  3. Choose the replacement image file to replace the thumbnail.

Replace thumbnail

Developer note
You can retrieve a video thumbnail using the cover attribute in your API request. Check out the GraphQL API reference for more details.

Adding video subtitles

You can add subtitles to your Mux videos in Prepr to provide multilingual support to your web app visitors and extend the web app accessibility.

The Subtitle feature is only compatible with the Mux web player. Read more in the Mux documentation (opens in a new tab).

To add subtitles, follow the steps below.

  1. Go to the Media tab and open the needed video file.
  2. On the Asset page, click +Add Subtitle.
  3. Choose a locale, and upload either an SRT or WebVTT file containing the subtitle information.

Prepr will automatically generate a subtitle URL and add it to the video in Mux.

Add subtitle

There's no limit on the number of subtitle files you can include in your video asset. Each subtitle file will be stored as an individual file asset in Prepr.

Learn more on how to add videos to your web app.

Was this article helpful?

We’d love to learn from your feedback