Settings → Domain lets you map your workspace to a hostname you control (for example app.example.com). After saving, AYSHX Support verifies the domain before it goes live and before Login Screen settings appear in the drawer.
Please note:
- Once a domain is verified, the domain field is locked — you cannot edit it from this panel.
- Until verification completes, the panel shows an amber message: contact AYSHX Support to verify your domain.
- Invalid hostnames are rejected (must be a valid domain pattern, max 253 characters, no leading/trailing dots or double dots).
- Login Screen branding in the drawer stays hidden until verification completes — plan your Branded login screen after DNS is live.
Configure a custom domain
- Open Settings → Domain (WORKSPACE section)
- Enter your hostname (placeholder example:
app.example.com) - Click Save domain
- Contact AYSHX Support to complete DNS verification
- When verified, the status shows Domain verified with a green checkmark
Domain states
| State | Domain field | Save button | What you see |
|---|---|---|---|
| No domain saved | Editable | Visible | Empty form |
| Saved, pending verification | Editable | Visible | Amber “Contact AYSHX Support…” message |
| Verified | Disabled (read-only) | Hidden | Green “Domain verified” message |
Domains are normalized to lowercase on save via PUT /api/tenants/{id} with customDomain.
Verification and downstream features
flowchart LR Enter[Enter domain] --> Save[Save domain] Save --> Pending[Pending verification] Pending --> Support[AYSHX Support verifies DNS] Support --> Verified[Domain verified] Verified --> Login[Login Screen section unlocked] Verified --> Branded[Branded login at custom host] Login --> Customize[Settings Login Screen]
After verification:
- Settings → Login Screen becomes visible in the drawer
- Configure branding in Branded login screen
Related articles
- Workspace profile and branding — workspace name and logo in the app
- Settings drawer overview — when Login Screen appears
- Workspace security checklist — review access after going live on a custom domain