Site Settings Reference
Look up public site, registration, security, theme, notification, and storage fields
Public settings are provided by the backend PublicSiteSettingsResponse. The following defaults apply when nothing is configured.
Public & Authentication Settings
| Field | Type | Default |
|---|---|---|
site_name | string | Clouisle |
site_description / site_url / site_icon | string | Empty |
auth_page_layout | centered or split | centered |
theme_mode | system, light or dark | system |
theme_branding_display | full, name_only, icon_only or hidden | full |
allow_registration | boolean | true |
require_approval | boolean | true |
email_verification | boolean | true |
enable_captcha | boolean | false |
sso_enabled | boolean | false |
sso_allow_password_login | boolean | true |
allow_account_deletion | boolean | true |
require_terms_acceptance_on_register | boolean | false |
Knowledge Base Uploads
kb_document_max_upload_size_mb defaults to 50 with a valid range of 1-1024. The backend upload endpoint reads this value at runtime; exceeding the limit returns a validation error.
Theme Colors
The theme supports page, card, border, sidebar, top navigation, accent, muted, and chart colors. Colors use hex format, for example #3b82f6 or #3b82f680 with transparency.
Security & Operations Fields
Security settings also include password minimum length, complexity, expiration, and history, session timeout (default 30 days, session_timeout_days), single session, maximum login attempts, lockout duration, captcha, and TOTP. Storage settings support the local file system and object storage; audit logs support retention days and archive paths.
Notification Channels
Email uses SMTP host, port, encryption, username, password, sender name, and address; DingTalk, WeCom, Feishu, and Slack support Webhook or enterprise app fields; generic Webhooks support custom headers, body templates, and HMAC secrets.
How is this guide?