Managing Assets

This guide covers how to use assets in your code, manage tags, work with folders and files, archive and restore assets, and use the Event Stream and Reports features. It also explains how to set upload restrictions.

Using Assets in Your Code

There are two ways to render assets on your instance:

Liquid Tags

Liquid tags render content on pages, templates, and database layouts. To use a Liquid tag for an asset:

1. Navigate to Assets > All Assets
2. Select the file you want to use
3. In the file detail panel, find the Liquid Code field
4. Click the copy button to copy the Liquid code snippet
5. Paste the Liquid tag into your page, template, or layout code

Direct URL

Use the direct URL to reference assets in Markdown content or external applications. To copy the URL:

1. Navigate to Assets > All Assets
2. Select the file
3. In the file detail panel, find the URL field
4. Click the copy button to copy the URL

You can use the URL in two ways:

• Full URL - Includes the complete domain path. Use this when referencing assets from an external site or a different instance.
• Relative URL - References the file path within the same instance. Use this for stability when developing on a specific instance.

File Tagging

Tags help you organize and search for files across your instance. To add or edit tags on a file:

1. Navigate to Assets > All Assets
2. Select the file you want to tag
3. Click the Edit Tags button in the toolbar
4. Enter your tags in the tag editor that appears
5. Save your changes

Once tagged, you can use the search bar in Tags mode to find files by their tags across all folders.

Managing Folders

Adding a Folder

1. Navigate to the directory where you want to create the folder
2. Click the Add Folder button in the toolbar
3. Enter the folder name in the dialog
4. Confirm to create the folder

Special characters in folder names are automatically replaced with hyphens.

Deleting a Folder

1. Select the folder you want to delete
2. Click the Delete Folder button in the toolbar
3. Type DELETE in the confirmation dialog to confirm

Deleting a folder permanently removes the folder and all files and subfolders inside it. This action cannot be undone.

Managing Files

Deleting a File

1. Select the file you want to delete
2. Click the Delete File button in the toolbar
3. Type DELETE in the confirmation dialog to confirm

Deleting a file permanently removes it from your instance. This action cannot be undone. If you want to remove a file but keep the option to restore it later, use archiving instead.

Archiving and Restoring Assets

Archiving a File

Archiving removes a file from the main file list without permanently deleting it. To archive a file:

1. Select the file
2. Click the Archive File button in the toolbar

Archived files are hidden from the main file list but can be restored at any time.

Viewing Archived Files

To view your archived files:

1. Navigate to Assets > All Assets
2. Click View Archived to switch to the archived files view

Restoring an Archived File

To restore an archived file back to the main file list:

1. Navigate to the archived files view
2. Select the file you want to restore
3. Click Restore

Event Stream

The Event Stream provides a chronological audit log of all asset-related activity on your instance. To access it:

1. Navigate to Assets > Event Stream

The Event Stream tracks the following actions:

• File added
• File edited
• File archived
• File restored
• File deleted
• Folder added
• Folder deleted

Each event shows the administrator who performed the action, the file or folder name, and the timestamp. You can filter events by date range and search by description text.

Reports

The Reports page shows a dashboard of your assets. It has an Overview (total assets, total storage with the change since last month, active versus archived storage), a Composition area (storage at the end of each month, assets added per month, assets by file type) and Rankings (top 10 largest assets, storage by folder, folders by asset count, tags, and uploads by administrator). To access it:

1. Navigate to Assets > Reports

The storage chart shows the total storage held at the end of each month.

Upload Restrictions

Upload restrictions control which files the file manager and the Assets API accept. To set them:

1. Navigate to Assets > Configuration
2. Choose a Mode. Denylist allows everything except the listed extensions. Allowlist allows only the listed extensions.
3. Type each extension and press Enter
4. Set Max file size (MB). Leave it empty for no limit. The platform limit is 600 MB.
5. Select Save

Changes affect new uploads only. Files already in your library are not checked again or removed. Extensions are matched on the part after the last dot, so evil.jpg.php counts as php.