Sign In
This section explains how users sign in to WorkspaceBuilder, how multi-organization login works, and what happens after a successful sign-in.
To sign in, visit the WorkspaceBuilder login page.
Authentication Overview
WorkspaceBuilder uses a secure authentication system that handles all login and session management — ensuring centralized, protected access control.
Passwords are never stored directly by the application. Login is handled by a dedicated secure layer that verifies your credentials and creates an authenticated session.
Sign-In Flow
Step 1 — Initiate Login
The user clicks the Login button on the WorkspaceBuilder landing page. The login screen is displayed.
Step 2 — Enter Email
The user enters their registered email address and clicks Next.
If the email is associated with multiple organizations, the platform displays an organization selector before asking for a password. See Multi-Organization Login below.
Step 3 — Enter Password
The user enters their password and submits.
Step 4 — Authentication and Redirect
The system validates the credentials. On success:
- A secure session is created.
- The user is redirected back to WorkspaceBuilder.
- The app loads the user's profile, organization data, and assigned roles.
A "Login successful" toast notification is displayed upon redirect. The user is taken directly to their Dashboard.
Post-Login Behavior
The behavior after login depends on whether the user has previously set up an organization:
| Scenario | Behavior |
|---|---|
| Returning user | Redirected directly to the Dashboard |
| First-time user (no organization) | Prompted to create an organization |
| Invited user | Taken directly into the organization they were invited to |
First-Time Organization Setup
If a user is logging in for the first time and has no existing organization:
- A modal appears prompting them to create a new organization.
- The system automatically assigns three default roles to the new organization:
AdminDesignerUser
- A confirmation toast is displayed.
- The user is automatically signed out and must sign in again to continue with the newly created organization.
After creating an organization for the first time, the user is logged out automatically. This is expected behavior — sign in again to access the new organization workspace.
Multi-Organization Login
A user's email may be associated with more than one organization — for example, if they own one organization and were invited to another.
How it works:
- After entering their email and clicking Next, the app checks how many organizations are linked to that email.
- Single organization — the app skips the selection step and goes directly to the password field.
- Multiple organizations — the app displays an organization selector listing all accessible organizations. The user selects one before entering their password.
Role assignment based on organization:
| Organization Type | Assigned Roles |
|---|---|
| Own organization | Admin, Designer, User |
| Invited organization | User (default — can be changed by an admin) |
Roles in an invited organization are controlled by that organization's administrators via the Workspace Settings tab.
Security Notes
| Aspect | Detail |
|---|---|
| Secure authentication | Passwords are never stored directly by WorkspaceBuilder — login is handled by a secure authentication layer |
| Session storage | Your session data is stored securely in the browser |
| Organization validation | The platform ensures you are mapped to the correct organization on every request |
| Session expiry | Sessions expire after a period of inactivity. Users are prompted to sign in again when a session expires |
Do not share your login credentials. If you suspect unauthorized access to your account, contact your organization administrator immediately.