Tenant Application Settings
Workspace-scoped branding and configuration with automatic fallback to Central Application defaults.
text
Tenant Setting (if configured)
↓
Central Application Default
↓
System Default (fallback)Guides
| Audience | Document |
|---|---|
| Workspace admins | tenant-settings-user.md |
| Engineers | tenant-settings-developer.md |
| Production / ops | tenant-settings-production.md |
| Object storage (Wasabi / S3) | object-storage.md |
Also see Central settings.md for platform-wide defaults.
What tenants can configure
| Group | Fields |
|---|---|
| General | Workspace Name, Application Name (optional override), Company Name, Timezone (single clock for reminders, dues, meetings, attendance), Locale, Currency |
| Security | Session timeout (minutes); 0 / Never timeout keeps users signed in until they sign out |
| Branding | Support email + invoice company profile (always). Logo, favicon, button color, and auth page images require Branded — otherwise Central defaults apply |
| SMTP host/port/user/password/encryption, From name/address | |
| Developers | API tokens and outbound event webhooks (settings.manage_developers) |
Tenants cannot change platform registration, maintenance mode, password policy, billing flags, or Central branding.
Resolution examples
| Value | Resolution |
|---|---|
| Application title | Tenant app_name → Workspace Name → Central app_name |
| Logo | Tenant logo → Central logo → system default |
| Button color | Tenant → Central → #111827 |
| Support email | Tenant → Central |
| SMTP | Tenant host configured? → Tenant SMTP : Central SMTP |
The SPA applies workspace branding after public settings load (and again after you sign in so the session can resolve your workspace). Until then the browser tab may show EloSync; sidebar and login brand text stay blank rather than showing a placeholder product name.
Asset storage
Uploads use Laravel Storage (FileUploadService). Locally they live under storage/app/public/; in production they live on the S3-compatible bucket. Relative keys are identical in both environments:
text
branding/logos/… # Central
branding/favicons/… # Central
tenants/{workspace_uuid}/
branding/logos/…
branding/favicons/…