Overview
StatusStack uses a hierarchical multi-tenant architecture to support teams of all sizes, from small startups to large MSPs managing hundreds of clients.Organizations
What is an Organization?
An Organization is the top-level entity in StatusStack that represents your company or business. Everything in StatusStack belongs to an Organization.Single Tenant
All your data is isolated from other Organizations
Subscription Billing
Subscription and billing are managed at the Organization level
Teams Management
Create multiple Teams within your Organization
Shared Resources
Share Sources and templates across Teams
Organization Settings
Manage your Organization from the dashboard:1
Navigate to Settings
Click Settings → Organization in the sidebar
2
Update Details
Configure Organization information:
- Organization Name
- Company Website
- Contact Email
- Time Zone
- Logo (for branding)
3
Manage Subscription
View and manage your subscription:
- Current plan (Free, Pro, Enterprise)
- Usage statistics
- Billing history
- Payment methods
Teams
What are Teams?
Teams provide logical separation within your Organization. Teams are perfect for:- Departments - Engineering, Operations, Support
- Environments - Production, Staging, Development
- Clients - MSP client management (Acme Corp, XYZ Inc.)
- Projects - Product A, Product B
Team Hierarchy
Creating Teams
1
Navigate to Teams
Go to Settings → Teams in the sidebar
2
Create New Team
Click “Create Team” button
3
Configure Team
Fill in team details:
4
Invite Members
Add team members with roles:
- Admin - Full team management
- Member - Create/edit resources
- Viewer - Read-only access
User Roles & Permissions
StatusStack has two levels of roles:Organization-Level Roles
Team-Level Roles
Permission Matrix
*Only within teams they’re a member of
Team Management
Inviting Team Members
- Via Dashboard
- Bulk Invite
- Navigate to Settings → Teams
- Select the team
- Click “Invite Member”
- Enter email address
- Select role (Admin, Member, Viewer)
- Send invitation
Managing Team Members
Change Role:- Go to team settings
- Find user in members list
- Click role dropdown
- Select new role
- Go to team settings
- Find user in members list
- Click “Remove” button
- Confirm removal
- Organization Owner only
- Go to organization settings
- Click “Transfer Ownership”
- Select new owner
- Confirm transfer
Multi-Team Workflows
Scenario 1: Department-Based Teams
Organize by company departments:- Clear ownership and responsibility
- Department-specific monitoring
- Targeted notifications per team
Scenario 2: Environment-Based Teams
Organize by deployment environment:- Environment isolation
- Role-based access per environment
- Separate notification rules
Scenario 3: MSP Client Teams
Managed Service Providers managing multiple clients:- Complete client isolation
- Client-specific branding
- Client portal access
- Per-client billing
Access Control Best Practices
Principle of Least Privilege
Principle of Least Privilege
Start restrictive, expand as needed
- New users → Viewer role initially
- Promoted to Member after training
- Only trusted users get Admin role
- Limit Organization Owners to 1-2 people
Team Separation
Team Separation
Keep teams focused
- Production teams separate from development
- Client teams isolated from each other (MSP)
- Clear ownership of Stacks and Monitors
Regular Access Review
Regular Access Review
Quarterly access audit
- Review active users
- Remove users who left company
- Verify roles are appropriate
- Update team memberships
Secure Invitations
Secure Invitations
Invitation hygiene
- Use company email addresses only
- Set expiration on invitations
- Verify identity before granting access
- Use 2FA for sensitive teams
Organization Limits by Plan
MSP-Specific Features
Client Portal Access
Grant clients view-only access to their monitoring:- Create a team for the client
- Invite client users with Viewer role
-
Client users can:
- View their Stack status
- See incident history
- Subscribe to email updates
- Access public status pages
-
Client users cannot:
- Modify Stacks or Monitors
- Access other clients’ data
- View billing information
- Change notification settings
Client Branding
Customize per-client branding:- Custom Logos - Upload client logo for their team
- Custom Colors - Match client brand colors
- Custom Domains - status.clientdomain.com
- White-Label - Hide StatusStack branding (Enterprise)
Common Scenarios
Adding a New Employee
1
Create User Account
Organization Admin invites user to Organization
2
Assign to Teams
Add user to appropriate teams (Engineering, Operations, etc.)
3
Set Team Roles
Assign role in each team (typically start with Viewer or Member)
4
User Accepts Invite
User clicks invitation link and creates account
Offboarding an Employee
1
Remove from Teams
Remove user from all teams in organization
2
Revoke Access
User automatically loses access to all resources
3
Audit Changes
Review any resources the user created or modified
4
Transfer Ownership
If user owned Stacks/Monitors, transfer to another user
Adding a New Client (MSP)
1
Create Client Team
Create a new team for the client: “Client: Acme Corp”
2
Set Up Stacks
Create client-specific Stacks within the team
3
Invite Client Users
Invite client stakeholders with Viewer role
4
Configure Branding
Customize logo, colors, and domain for client
5
Share Status Page
Provide client with their branded status page URL
Troubleshooting
User Can’t Access a Stack
Check:- User is member of the correct team
- Stack belongs to that team
- User has at least Viewer role
- User accepted team invitation
User Can’t Create Resources
Possible Causes:- User has Viewer role (read-only)
- Organization quota reached (upgrade plan)
- User not member of any team
Invitation Not Received
Solutions:- Check spam/junk folder
- Verify email address is correct
- Resend invitation
- Try different email provider
Next Steps
MSP Setup Guide
Configure multi-client monitoring
Team Management
Detailed team management documentation
User Roles
Security and access control
Subscription Plans
Compare plans and features

