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.
Upload
Section titled “Upload”To upload one or more files, click Upload files or drag and drop them into the active window.
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, the Advanced options button transforms into a clickable Fill Required fields badge. To complete the upload, select it and fill out the mandatory fields (marked with a red asterisk) in the Overview pane.
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
Section titled “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.
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.
There are three ways to perform actions on a 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.
- Check the checkbox in the upper-left corner and select 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
The Overview window provides configuration options for metadata, such as tags, title, alt text, and copyright. The appearance of this information on your website depends on the implementation configured by your developer.
The Overview window provides additional options for JPEG and PNG files:
- Add a focal point to an image. Hover over it and click to add a focal point. To remove a focal point, click the camera focus button.
- Change the background color of a PNG.
- 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.
When multiple assets are selected, a toolbar appears with bulk actions, such as adding and removing tags.
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.