Settings → Login Screen (WORKSPACE) customizes what users see on the login page when they sign in through your verified custom domain. The 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); replacing a file deletes the previous asset.- Background video plays muted, looped, behind the login panel; without a video, default branding is shown.
- Heading text (max 200 characters) appears on the left panel when the video is not yet playing; leave blank for the default 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 → Login Screen
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 when video is not playing; placeholder example: “Have the edge over your competitors” |
| Background video | MP4 or WebM upload | Max 50 MB | Plays muted behind the login form; preview shown after upload |
Click Save changes to persist loginScreenLogoUrl, loginScreenVideoUrl, and loginScreenHeading on the tenant record.
Login page layout
flowchart TB
subgraph Page[Login page on custom domain]
Video[Background video muted loop]
Panel[Login panel]
Logo[Login logo]
Form[Sign-in form]
end
Video --> Page
Panel --> Logo
Panel --> Form
Heading[Heading text] --> Panel
Video -.->|when not playing| Heading
Workflow
- Upload or remove Login logo as needed
- Set optional Heading text
- Upload or remove Background video
- Click Save changes
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