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.

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 your instance storage usage over time as a line chart. To access it:

1. Navigate to Assets > Reports

Use the date range filter to view storage usage for a specific period. The chart displays monthly data points showing total storage used in megabytes.