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 it from the user menu (top-right) → Settings.Documentation Index
Fetch the complete documentation index at: https://docs.websitestudio.app/llms.txt
Use this file to discover all available pages before exploring further.
Site Identity
Set your website’s name, tagline, and browser favicon.| Field | What it does |
|---|---|
| Site Name | Shown in the browser tab title (“Studio — Your Site Name”), the logo tooltip, navigation, and metadata |
| Tagline | A short description of your site — used by the AI when generating and editing pages |
| Favicon | Your browser tab icon (.ico format, max 512 KB) |
.ico file onto the favicon area. A live preview appears immediately. To remove a custom favicon, click the trash icon next to it.
Click Save Identity to apply changes.
AI Provider
Configure which AI model powers your website generation.
You can switch providers and models at any time. Your previous API keys are preserved — switching back restores your configuration.
Click Save Settings to apply changes.
Supported providers
| Provider | Get your API key | Notes |
|---|---|---|
| Anthropic Claude | console.anthropic.com | Recommended — best results |
| OpenAI | platform.openai.com | |
| Google Gemini | aistudio.google.com | |
| DeepSeek | platform.deepseek.com | Budget-friendly |
| OpenAI Compatible | — | Ollama, LM Studio, or any OpenAI-compatible server. No key needed for local servers. |
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.Expert review 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.
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
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.
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.”
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)
Usage data persists across design switches and site resets. Only Reset Installation (which deletes the entire database) wipes usage data.
System Status
A snapshot of your runtime environment:| Metric | What it shows |
|---|---|
| VoxelSite | Your installed version |
| PHP | PHP version running on your server |
| SQLite | SQLite library version |
| Database | Size of your Studio database file |
| Preview Files | Total size of your website’s preview files |
| Assets | Total size of uploaded images, fonts, and files |
| Upload Limit | Maximum file upload size allowed by your server |
| Memory Limit | PHP memory limit |
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:- Drag-and-drop upload
- FTP fallback
Drag-and-drop (or click to browse) and upload the
.zip release directly from the Settings page.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
_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)
Optional capabilities
Below the role dropdown, an Optional capabilities section lets you grant additional scopes not included in 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.
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:* (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./_studio/api/agent/v1/schema — no authentication required. Import it into agent frameworks, Postman, or code generators.
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 submissions
- Site Memory and Design Intelligence data