Settings

The Settings page is the control center for your VoxelSite installation. Only the site owner can access it — editors and viewers do not see it.

Open Settings from the user menu (top-right) → Settings. Only the site owner sees this option.

Site Identity

Your website's name and description, plus the browser favicon.

Favicon upload: Click the Upload button or drag-and-drop a .ico file onto the favicon area. A live preview shows immediately. To remove a custom favicon, click the trash icon next to it.

Click Save Identity to apply changes.

AI Provider

Configure which AI powers your website generation.

1. Select a provider from the list below
2. Enter your API key — encrypted at rest using AES-256-CBC
3. Test Connection — click to verify your key works before saving
4. Choose a model — VoxelSite loads available models from your provider automatically
5. Max Output Tokens — controls how much content the AI generates per request (default: 32,000). Higher values allow larger generations but cost more.

You can switch providers and models at any time. Your previous API keys are preserved — switching back restores your configuration.

Expert review after generation

Below the token setting, an optional toggle enables a post-generation quality review. When turned on, VoxelSite makes an additional AI call after each generation to surface heuristic HTML, accessibility, and SEO suggestions — for example, heading hierarchy issues, missing alt text, or broken internal links.

Results appear in a collapsible "Expert Review" panel in the chat, below the list of modified files. Each suggestion includes the severity (error, warning, or info), the affected file and line, a description, and a suggested fix. Click Add to chat → on any suggestion to append a targeted follow-up prompt to the chat input.

This feature is off by default. It does not auto-fix issues — results are advisory, intended for users comfortable reviewing web-design advice. Enabling it adds a few seconds and extra tokens per generation.

Click Save Settings to apply changes.

Supported providers

Email & Notifications

Configure how VoxelSite sends notification emails when forms are submitted. Four delivery methods are available:

• SMTP — most reliable; presets for Gmail, Outlook, Yahoo, iCloud, Zoho, and custom servers
• PHP mail() — uses your server's built-in mail function; no configuration needed
• Mailpit — for local development and testing
• None — email disabled; submissions are still stored and visible in the Studio

See Email Configuration for detailed setup instructions, SMTP presets, security, and troubleshooting.

AI Knowledge

After you've generated a site, the AI Knowledge card shows what VoxelSite has learned about your business and design preferences. Two files are displayed:

• Site Memory — facts the AI has picked up from your conversations: business name, phone number, opening hours, team members, key services. Shows the number of stored facts.
• Design Intelligence — the AI's design decisions: chosen fonts, color temperature, spacing rhythm, layout approach. Shows the number of tracked decisions.

Click either card to open a read-only viewer showing all stored values.

You can't edit these values directly — tell the AI in chat to update them. For example: "Our new phone number is 555-0123" or "Switch to a warmer color palette."

For more on how the AI uses this knowledge, see The AI Engine → Site Memory.

AI Usage

Track your AI token consumption across all models you've used. The usage card shows:

• Total requests — how many AI generations you've triggered
• Input tokens — total tokens sent to the AI (your prompts plus site context)
• Output tokens — total tokens generated by the AI (the code and content it writes)

If you've used multiple models, a per-model breakdown appears below the totals.

Usage data persists across design switches and site resets — starting a new design or resetting the website does not clear your usage history. Only Reset Installation (which deletes the entire database) wipes usage data.

Token counts help you estimate costs. Check your AI provider's pricing page for per-token rates.

System Status

A snapshot of your runtime environment:

Use this information when reporting issues or checking whether your server meets the requirements.

Update

Upload a new version of VoxelSite to update your installation. Your pages, settings, database, and uploaded files are preserved — only system files are replaced.

The Update card shows your current version and provides two ways to update:

1. Drag-and-drop (or click to browse) — upload the .zip release directly
2. FTP fallback — upload the .zip to the /dist/ folder via FTP, and it appears here automatically with an Apply Update button

After a successful update, click Reload Studio to load the new version.

For full update instructions, including what's preserved and troubleshooting tips, see Updating VoxelSite.

Server Logs

Download or delete server log files for debugging. Each log entry shows the filename, line count, file size, and last modified date.

• Download — click the download icon to save a log file to your computer
• Delete — click the × icon on individual logs, or Delete all to clear everything

Log files are stored in _studio/logs/ and rotate daily. Share them with support when troubleshooting issues.

API Access

Enable and configure the Agent API — authenticated REST endpoints for external AI agents and automation tools.

Enable

Toggle Enable Agent API to allow external tools to connect. The API is disabled by default and blocked in Demo Mode.

API Keys

Click Generate Key to create a new API key. Each key has:

• Label — a name to identify the key (e.g. "Zapier", "My Agent")
• Role — sets the permission ceiling: Agent, Editor, or Viewer
• Scopes — granular permissions within the role (e.g. pages:read, publish:trigger)

The key is shown once after generation. Copy it immediately — it cannot be retrieved later.

Optional capabilities

Below the role dropdown, an Optional capabilities section lets you grant additional scopes that are not part of any role's defaults:

• AI Prompt Execution — allows the key to run AI prompts that can create pages, edit content, and modify your site. This is an opt-in capability because the prompt engine has full workspace write access.

Viewer keys cannot receive AI Prompt Execution. Because the viewer role is read-only, granting prompt execution to it would violate that contract. The checkbox is disabled when Viewer is selected.

This scope requires exec() on the server. See Common Issues → Prompt execution if you encounter a 503 error.

The key table shows all active keys with their prefix, label, role badge, creation date, last used date, and an AI badge for keys with prompt:execute. Click the trash icon to revoke a key.

Allowed Origins (CORS)

The Allowed Origins textarea controls which domains can make cross-origin requests to the Agent API. Enter one origin per line:

https://yourdomain.com
https://app.zapier.com

Leave as * (default) to allow all origins.

Nginx users: The Agent API requires Authorization header forwarding in your Nginx config. See Nginx Configuration for details. Routing works automatically — no Nginx rewrite rule is required.

A View API schema link in the card header opens the public OpenAPI 3.0 specification (/_studio/api/agent/v1/schema) — no authentication required. Import it into agent frameworks, Postman, or code generators.

For the full endpoint reference, authentication details, and code examples, see Agent API.

Danger Zone

Two destructive actions are available at the bottom of the Settings page. Both require confirmation.

Reset Website

Clears your website and starts fresh. This removes:

• All generated pages, partials, styles, and scripts
• Conversation history and AI logs
• Revision history (undo/redo) and snapshots
• Form definitions and form submissions
• Action definitions and action records
• Site Memory and Design Intelligence data

This preserves your settings, API keys, team accounts, uploaded images/files/fonts, and AI usage data. After resetting, you can immediately start a new conversation with the AI to generate a new site.

Use this when you want to start over with a completely different website concept without losing your configuration.

Reset Installation

A full factory reset. This removes everything — database, configuration, uploaded files, and all generated content. After confirming, the installation wizard appears so you can set up VoxelSite from scratch.

This is irreversible. Back up _studio/data/, assets/, and _data/ first if you want to preserve anything.

Related

• Agent API — REST endpoints for external AI agents and automation tools
• Email Configuration — detailed SMTP setup, presets, and testing
• Updating VoxelSite — full update guide with FTP fallback and troubleshooting
• The AI Engine — how Site Memory and Design Intelligence work
• Requirements — PHP version, extensions, and server setup
• Customizing the Studio — modifying the Studio source code