Assets

VoxelSite includes a built-in asset manager for uploading and organizing images and files.

Uploading

Upload files by:

• Drag and drop — Drag files directly into the Assets tab
• Click to browse — Click the upload zone to select files from your computer

Uploaded files are stored in the assets/ directory on your server:

Using assets in your site

When the AI builds or edits your pages, it sees your uploaded assets and can reference them. Tell it:

• "Use the logo I uploaded for the header"
• "Add the team photos to the about page"
• "Put the PDF menu in the footer as a download link"

The AI references uploaded files by their exact paths — no external URLs or CDN links.

Managing assets

From the Assets tab you can:

• View all uploaded files in a grid or list
• Delete files you no longer need
• See metadata — file size, dimensions (for images), upload date

Organized structure

Assets are placed in appropriate subdirectories:

• assets/images/ — Photos, logos, graphics
• assets/files/ — PDFs, documents, downloads
• assets/icons/ — SVG icons (pre-installed Lucide icon set)
• assets/data/ — Structured JSON data (AI-generated)
• assets/css/ — Stylesheets (AI-generated)
• assets/js/ — JavaScript files (AI-generated)

When no images are uploaded

If you haven't uploaded your own images, VoxelSite uses its built-in image library — 132 curated editorial photographs that ship with every installation. The AI selects images by matching tone, mood, and category to your site's design personality.

Once you upload your own images, the AI uses those instead. Library images are always treated as defaults.

See Image Library for details on the built-in images, the naming convention, and how to create matching images with MidJourney.