Assets Overview

The Assets module is a file manager for your Insites instance. It lets you upload, organize, and manage files such as images, documents, audio, and other media that power your web application.

Why Use It

Hosting files directly on your instance gives your web application stability and independence from external sources. When you upload assets to your instance, they are served via a CDN for fast delivery worldwide. You have full control over your files, can organize them into folders, tag them for easy searching, and use them anywhere in your pages, templates, and database layouts with a simple Liquid tag or direct URL.

Use Cases

• Store and serve product images for an ecommerce store
• Manage a client-facing document library with downloadable PDFs and guides
• Host brand assets (logos, icons, fonts) used across your web application
• Maintain a media library of images for articles, blog posts, and content pages
• Archive older files you no longer need on the live site but want to keep for reference

Key Features

• File Upload - Upload up to 100 files at once, with a maximum size of 100MB per file
• Folder Management - Organize your files into a folder hierarchy
• Search - Find files by name or by tags
• File Preview - Preview images directly in the admin panel (supports PNG, JPG, JPEG, GIF, SVG, TIFF, BMP, and WEBP)
• Tagging - Add tags to files for better organization and filtering
• Archiving - Archive files you no longer need without permanently deleting them
• Event Stream - Track all file and folder activity with a detailed audit log
• Reports - Monitor your storage usage over time
• Liquid Code Integration - Copy ready-to-use Liquid code snippets for rendering files in your pages and templates
• Direct URL Access - Use file URLs directly in Markdown or external applications

Getting Started

Navigate to Assets in the sidebar to access the module. You will find three sections:

1. All Assets - The main file manager where you browse, upload, and manage your files and folders
2. Event Stream - A timeline showing all file and folder activity on your instance
3. Reports - A storage usage chart showing how much space your files are using over time

Start by navigating to All Assets to explore your current files and folders, or upload your first file.

Learn More

• Navigation - How to browse files and folders, use the toolbar, search, switch view modes, and view file details
• Uploading and Downloading Assets - How to upload files, handle duplicates, detect archived files, and download assets
• Managing Assets - How to use assets in your code, manage tags, create and delete folders, archive and restore files, and use the Event Stream and Reports