Settings → Domain (once verified) customizes what users see on the login page when they sign in through your verified custom domain. The branding section is hidden until customDomain is set and customDomainVerified is true.
Please note:
- Uploads are stored publicly under tenant media folders (
login-logos,login-videos,login-backdrops); replacing a file deletes the previous asset.- Background media can be an image or a video. Videos play muted and looped behind the login panel; without media, default branding is shown.
- Heading text (max 200 characters) appears below the login panel; leave blank for no custom tagline.
- This panel appears only after Custom domain is saved and verified — the in-app navigation logo is configured separately under Workspace profile and branding.
Prerequisites
- Save a hostname under Custom domain
- Complete verification with AYSHX Support
- Open Settings → Domain (verified) to edit login branding
Customization options
| Card | Field | Limits | Behavior |
|---|---|---|---|
| Login logo | Image upload | JPEG, PNG, GIF, WebP; max 5 MB | Shown at top of login panel; transparent/light logos work best on dark backgrounds |
| Heading text | Tagline on login panel | Max 200 characters | Shown below the login panel; placeholder example: “Have the edge over your competitors” |
| Background | Image or video upload | Images max 8 MB; videos (MP4/WebM) max 50 MB | Image covers the page, or video plays muted behind the login form |
Click Save login screen to persist loginScreenLogoUrl, loginScreenVideoUrl (background media URL), and loginScreenHeading on the tenant record.
Login page layout
flowchart TB
subgraph Page[Login page on custom domain]
Media[Background image or video]
Panel[Login panel]
Logo[Login logo]
Form[Sign-in form]
end
Media --> Page
Panel --> Logo
Panel --> Form
Heading[Heading text] --> Panel
Workflow
- Upload or remove Login logo as needed
- Set optional Heading text
- Upload or remove Background (picture or video)
- Click Save login screen
Related articles
- Custom domain — required before this section appears
- Workspace profile and branding — navigation bar logo (separate from login logo)
- Settings drawer overview — WORKSPACE section map