Use Settings → Settings (under the WORKSPACE section) to configure how your tenant appears and how dates, money, and support mail behave. The panel title in the app is Workspace Settings, split into profile fields and a Region block.
Please note:
- Subdomain and Current Plan are read-only — subdomain cannot be changed after workspace creation.
- Logo uploads replace the previous file in storage; removing a logo deletes it from media storage.
- Theme selection moved to Settings → Theme under PERSONALIZATION — not this panel.
- A verified custom domain is required before you can customize the login page — save the hostname under Custom domain, then configure Branded login screen.
Open the panel
- Open Settings from the sidebar rail
- Under WORKSPACE, select Settings
- Edit fields and click Save Changes (each section has its own save button)
Workspace profile fields
| Field | Editable | Purpose |
|---|---|---|
| Workspace Name | Yes | Display name for the tenant |
| Data hosting | Read-only badge | Shows database placement when configured |
| Custom helpdesk email | Yes (optional) | Routes inbound mail to your workspace; leave empty to use the GSWORD helpdesk address only |
| GSWORD helpdesk inbox | Read-only | System inbound address for ticketing; configure your Resend inbound domain for the shown domain |
| Workspace Logo | Yes | Shown in the navigation bar; JPEG, PNG, GIF, or WebP, max 5 MB, square recommended |
| Subdomain | No | Assigned at creation |
| Current Plan | No | Your subscription tier |
Region settings
| Field | Purpose |
|---|---|
| Timezone | How dates and times display across the workspace |
| Currency | Default currency for deals and financial records |
| Country/Region | Geographic region; searchable country picker with flags |
Timezone and currency use dropdown lists; country/region supports search by name or ISO code.
Logo upload flow
sequenceDiagram participant Admin participant Settings as Settings panel participant Media as Media API participant Tenant as Tenant API Admin->>Settings: Upload logo file Settings->>Media: POST /api/media/upload folder logos Media-->>Settings: CDN URL Settings->>Media: Delete previous logo if any Admin->>Settings: Save Changes Settings->>Tenant: PUT /api/tenants id name logoUrl timezone etc Tenant-->>Settings: Success refresh tenant
Related settings
- Custom domain — host the app on your own hostname
- Branded login screen — customize login after domain verification
- Settings drawer overview — full drawer map
For module toggles and defaults, see Configure your workspace.