Uploading Assets
Once you have a pack, you can start adding assets to it. This guide covers the upload process, file requirements, and what happens when your storage is running low.
Opening the Upload Form
Navigate to a pack you own by clicking its card on the Visual Assets page. From there, you can open the upload form in two ways:
- Click the Upload button in the toolbar
- If the pack is empty, click the Upload button in the empty state
The upload form opens in a modal dialog.
Filling In the Upload Form
The form has three fields:
- File (required) — Click to browse or select a file from your computer. The selected filename and file size are displayed.
- Folder / Category (optional) — Assign the asset to a category for easier filtering later. You can type any name — categories are created automatically.
- Tags (optional) — Add comma-separated tags to help find the asset when searching.
Click Upload to start the upload. When it completes, the asset appears in the pack grid immediately.
Supported Formats and Size Limits
Each file can be up to 10 MB. The following formats are accepted:
| Format | Extension | Best For |
|---|---|---|
| SVG | .svg | Vector illustrations and icons (smallest file size) |
| PNG | .png | Raster illustrations with transparency |
| JPEG | .jpg, .jpeg | Photos and detailed artwork |
| WebP | .webp | Modern compressed images |
| GIF | .gif | Simple animations or legacy assets |
Tip: SVG is the most storage-efficient format. A single SVG illustration typically uses a few kilobytes, while a PNG of the same image can use hundreds of kilobytes or more.
Quota Check During Upload
Before the upload starts, the system checks whether adding the file would exceed your storage quota. You may see one of these states:
- Normal — Plenty of space available. Upload proceeds normally.
- Warning — The upload would push your usage above 80% or 90%. A yellow or red alert appears showing projected usage (e.g., "45.2 / 100.0 MB after upload"). You can still upload.
- Blocked — Your storage is full. The Upload button is disabled and a "Storage limit reached" message appears. You need to free up space before uploading.
Tips for Preparing Assets
- Use SVG when possible — Vector files are small and scale perfectly on any card size
- Optimize PNG and JPEG files before uploading — tools like TinyPNG or Squoosh can reduce file size significantly
- Choose a meaningful name — The filename becomes the asset name (you can rename it later)
- Set a category at upload time if you already know where it belongs — this saves time organizing later
Next Steps
- Organize your assets into categories and edit metadata
- Understand storage quotas and how to manage your usage