Assets

Storyblok includes a native digital asset manager (DAM) to upload images, videos, audio, and text in popular formats (including PDF, DOC, and TXT). Navigate to the Assets tab to manage your files.

Note

For technical details about how to handle assets in your codebase, visit our Assets Developer Documentation.

Upload

To upload one or more files, click Upload files or drag and drop them into the active window.

Note

Some file types are only available on paid plans. Learn more on our pricing page.

Inside the Upload window, rename the file, mark it as private, provide metadata via Advanced options, add more files, or delete assets before uploading. This is the only opportunity to rename the file, as file names cannot be changed after uploading.

Depending on the space settings, some metadata fields may be required during the upload process. In this case, select Advanced options and fill out the required fields at the top (these are marked with a red asterisk).

The asset overview window

When an asset is marked as private, it is hidden. To mark a file as private, toggle the lock button. Optionally, schedule a publishing date and time to make the asset public at a later date.

Organize

Use the asset manager to search, filter, and sort files. The asset manager includes both a tagging system and a folder system for organizing assets.

Note

Access to assets may depend on your role. For more information, contact your space administrator.

Use the Search bar to find assets by file name or file type.

Use the Sort dropdown menu to order displayed assets. The default sorting is by creation date (that is, when assets were uploaded), from newest to oldest.

Use the Filter dropdown menu to perform an advanced search. Apply one or more filters and create queries to display results based on the relevant criteria.

Use the checkboxes to select assets and perform bulk actions.

The Deleted assets tab stores discarded files until emptying. To recover a deleted asset, click the restore icon. To recover multiple deleted assets, select them by their checkboxes and click Restore assets.

To “empty the trash”, click Permanently delete all. Note that this action cannot be undone and affects all assets. There's no way to remove files individually.

The tagging system offers a way to organize assets across folders. Asset tags are separate from block, story, and idea tags.

Edit

There are three ways to perform actions on a single file, each providing slightly different functionality.

• Click the asset to open the Overview window.
• Hover over the asset, open the three-dot menu, and click the relevant action.
• Select the checkbox in the upper-left corner and choose the relevant action from the top toolbar.

The universal actions available in all methods are:

• Preview
• Edit an image
• Copy the URL
• Move to folder
• Delete

To tag, move, or delete multiple assets, select them and then choose the desired option from the toolbar.

Open the Overview window to add or edit asset metadata such as tags, title, alt text, copyright, and other custom fields. Depending on the project's setup, this information may be visible on the website.

The Overview window provides additional options for JPEG and PNG files:

• Add a focal point. To mark the area that should remain centered when resizing the asset, hover over the image and click. To remove a focal point, click the camera focus button.
• Change the background color of a PNG file.
• Apply image transformations.

If AI alt text is enabled in your space (under Settings → AI Settings), the Generate Alt Text button will produce alt text for PNG, JPEG, and WEBP images. Always verify AI-generated text.

Translate metadata fields

To translate an asset's metadata fields, open the Assets library, select the file, and then choose a language from the drop-down. Toggle the globe icon to enable translation and provide the appropriate translation to match the Default language value.

Note

AI translation doesn't apply to Asset metadata fields.

Track

The References tab on each asset displays the stories that include the asset.

The Replace Asset app will swap assets globally from the main asset manager window. This is useful when you need to upload a new version of a file that's used across multiple stories.