> ## 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.
# Workspace Settings — VoxelSite Control Center
> Configure your site identity, AI provider, email notifications, API access, and manage your VoxelSite installation from the Settings page.
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**.
## 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) |
To upload a favicon, click **Upload** or drag-and-drop a `.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.
Choose from the list of supported providers below.
Your key is encrypted at rest using AES-256-CBC.
Click **Test Connection** to verify your key works before saving.
VoxelSite loads available models from your provider automatically.
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.
Click **Save Settings** to apply changes.
### Supported providers
| Provider | Get your API key | Notes |
| --------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| **Anthropic Claude** | [console.anthropic.com](https://console.anthropic.com/account/keys) | Recommended — best results |
| **OpenAI** | [platform.openai.com](https://platform.openai.com/api-keys) | |
| **Google Gemini** | [aistudio.google.com](https://aistudio.google.com/apikey) | |
| **DeepSeek** | [platform.deepseek.com](https://platform.deepseek.com/api_keys) | 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.
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."
## 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. 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 |
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:
Drag-and-drop (or click to browse) and upload the `.zip` release directly from the Settings page.
Upload the `.zip` to the `/dist/` folder via FTP. It appears in the Settings page automatically with an **Apply Update** button.
After a successful update, click **Reload Studio** to load the new version.
## 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 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.
This scope requires `exec()` on the server. See [Common Issues → Prompt execution](/troubleshooting/common-issues) 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](/troubleshooting/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 at `/_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.
These actions cannot be undone. Back up your data before proceeding.
### 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
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.
### 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.