Asset library

To add one file, open a project in Assets, choose Assets → Asset Library in the sidebar, then Upload. All Media has the same Upload button.

1. In Upload assets, drop a file on the box or click it to choose one. The dialog takes one file at a time.
2. Check Asset name. Assets fills it in from the file name, and you can change it.
3. Optional: in Destination folder, choose a folder. Without one, the asset goes in Project root.
4. Optional: change Type, which Assets picks from the file, and Status, which starts as Draft.
5. Optional: turn on Upload lossless to store the file exactly as it is. With it off, Assets converts images to WebP at up to 2048 px to save storage and bandwidth. PSD, TIFF and RAW files always upload untouched.
6. Choose Upload. A bar shows each step, and the asset appears in the library when it's done.

Uploading needs a role that includes Edit an asset, which every built-in role except Viewer has. To upload many files at once, or from a link or another service, use the Upload Center, covered in Uploads and requests.

Every asset has a status and a type, shown as colored labels across the library.

• Status is where the asset is in its life: Approved, Draft, In Review, Processing or Archived. Assets uploaded from the library start as Draft unless you pick another status.
• Type is the kind of file: Image, Video, Audio, Document, PDF, 3D Model, Raw or Archive. Assets picks it from the file when you upload, and you can change it.

Archived assets stay in the library with the Archived label, and they're also listed under Archive & Trash, where restoring one sets it back to Draft. Deleted assets are different: they leave the library for the trash. See Archive and trash.

Changing an asset's status, for example to Approved, can also start a workflow that watches for it. See Workflows.

All Media, right under Overview in the sidebar, shows every asset in the project as a grid of thumbnails that keep each file's own shape. Click a thumbnail to open the asset's quick view.

• Type filter: All Types by default, or one type, such as Image or Video.
• Sort: Last Modified (the default), Oldest Modified, Name A–Z, Name Z–A, Largest Size, Smallest Size or Most Downloaded.
• Search: matches asset names, file formats and tags.

The grid shows 50 assets a page; switch to 10, 25 or 100 at the bottom. When nothing matches, Clear filters resets the search and the type filter.

Assets → Asset Library lists every asset in the project, newest change first. The figures across the top count the whole library: Total assets, Storage used, Approved and Processing. Search and filters don't change them.

Each row shows the asset's thumbnail, name, format, size and folder, then its Status, Type, Modified date and Downloads. Narrow the list with the type filter (All Types) and the status filter (All Statuses), or search by name, format and tags.

The list shows 25 assets a page; switch to 10, 50 or 100 at the bottom. Searches you run here and in All Media, and the results you open from them, are counted in Search Analytics. See Analytics.

Click an asset in the Asset Library or All Media to open its quick view, a panel on the right. Changes here save as you make them.

• Status: pick a new status.
• Tags: type a tag and press Enter or a comma. The × on a tag removes it.
• Description: shown when the asset has one. Edit it in the asset editor.
• Details: type, dimensions, folder, downloads, number of versions and relationships, and when it was modified.

At the bottom, Edit opens the asset editor, the download icon saves the file, the copy icon duplicates the asset, and Delete moves it to the trash after you confirm.

Each row's ⋯ menu in the Asset Library has every action for that asset.

• Open shows the quick view, and Edit opens the asset editor.
• Open Containing Folder opens Folders at the asset's folder.
• Download → Original file saves the stored file. For images, As WebP, As JPG and As PNG save a converted copy; they need delivery turned on for the asset and URL transforms turned on for the project.
• Share → Copy delivery link copies the asset's public delivery address, and only works once delivery is on for it. Create share link makes a private share link that allows downloads, expires in 30 days and is copied for you. Manage shared links opens Shared Links.
• Copy URL copies a delivery address for the Original file and, for images, an Optimized copy or a Thumbnail (512px). These need delivery on for the asset too.
• Rename, Replace, Duplicate and Add to Collection change or copy the asset.
• Delete moves the asset to the trash after you confirm.

Delivery is covered in Delivery and share links in Collaboration.

All four actions are in each asset's ⋯ menu in the Asset Library.

• Rename changes the name shown across the project; the stored file isn't touched. Rename needs a name.
• Replace asks for a new file and makes it the asset's current version. The previous file stays in the asset's version history, where you can restore it.
• Duplicate asks first, then creates a Draft copy with the same name plus (copy), tags and details. The file itself isn't copied, so use Replace on the copy to give it one.
• Add to Collection lists the project's collections with their asset counts. Click one to add the asset; it stays where it is in the library. Adding an asset to a collection that already holds it shows an error.

To delete an asset, choose Delete in its ⋯ menu or at the bottom of its quick view, then Delete again to confirm. The asset leaves the library and moves to the trash.

From the trash, under Assets → Archive & Trash, you can restore the asset or delete it permanently, which removes its file and every version for good. See Archive and trash.

Deleting needs a role that includes Delete an asset. Of the built-in roles, Owner and Admin have it; Manager, Member and Viewer don't. Roles are covered in Project settings.

To open an asset's editor, choose Edit in its ⋯ menu or its quick view. The editor fills the screen, with Asset Library at the top left to go back. Its sections are listed on the left: Overview, then Asset details, Relationships, Versions, Delivery and Technical. The search box there finds a section by name.

Overview previews the file with its status, format, size, dimensions and folder, counts its downloads, versions and links, and has Open file and Download.

Edits to the details, tags, accent color and delivery switch wait for Save Changes at the top, or Ctrl S (⌘ S on Mac). Discard drops them. If you leave the editor or switch sections with unsaved edits, Assets asks whether to Save, Discard or Keep editing. Relationships, version restores and file replacements save straight away.

The Asset details section of the asset editor holds what people search and filter by. Save your edits with Save Changes.

• Name: required. Assets won't save an empty name.
• Description: free text. An asset with no description and no tags counts as missing metadata on the project overview.
• Status and Type: the same options as everywhere in the library.
• Folder: pick an existing folder, or type a new name and choose Create to start one.
• Tags: type a tag and press Enter or a comma. Tags are saved in lowercase, and a tag the asset already has is ignored. Backspace in the empty box removes the last tag.

The Technical section shows the file as it was stored: original file name, MIME type, format, dimensions, size, storage status, checksum, and the asset's ID, creator and dates. Its Accent colour sets the color behind the asset's type icon across the library.

Relationships link an asset to its originals, variants and the work it belongs to. In the asset editor, open Relationships and choose Add relationship.

1. In Relation, choose Parent, Child, Derived, Variant, Source, Campaign or Product. It starts on Derived.
2. In Asset, search the project's other assets and pick one. Assets already linked aren't offered. To link something that isn't an asset, such as a campaign or a product, choose Link by name instead and type its name.
3. Choose Add link.

Links save straight away. Each one shows the linked asset or name and its relation; links made by name are marked Linked by name. The × beside a link removes it at once, without asking.

Every file uploaded to an asset is kept as a version. The Versions section of the asset editor lists them as v1, v2 and so on, each labeled with its file name, size and date, and marks the one in use as Current.

• Replace file uploads a new file and makes it the current version. The same happens with Replace in the asset's ⋯ menu.
• Restore, beside an older version, makes that file current again. Nothing is deleted, so you can switch back the same way.

A duplicated asset starts with no versions until you replace its file.

Delivery gives an asset a public address that websites and apps can load it from. Turn it on in the asset editor's Delivery section with Enable delivery, then choose Save Changes. While it's off, every delivery address for the asset returns not found. New uploads start with delivery on when the project's Deliver new assets by default setting is on.

Once delivery is saved, the asset has a file and the project's URL transforms setting is on under Settings → General, the Playground previews a transformed copy:

• Width (800 to start) and Height, in pixels.
• Crop: Fill (the default), Fit, Cover, Contain, Pad, Crop or Thumb.
• Format: Auto (the default), WebP, AVIF, JPEG or PNG.
• Quality: Auto (the default), 60, 70, 80 or 90.
• Effect: None, Blur, Sharpen, Grayscale, Sepia, Negate, Brightness, Contrast, Saturation or Tint.

The copy icon copies the transformed copy's address. Anyone with a delivery address can load the file without signing in, unless the project's delivery settings limit it. See Delivery.