Multi-Tenant Architecture
How organizations work, data isolation, workspace concepts
Verk is built around organizations - your own dedicated workspace where your team collaborates on projects and tasks. Each organization is completely separate, giving you the flexibility to work with multiple teams while keeping everything organized.
What is an Organization?
Your Dedicated Workspace
An organization in Verk is like your team's own office space - everything inside it belongs to your team.
What's included in an organization:
- All your projects - Every project you create lives in your organization
- Team members - People invited to your workspace
- Tasks and data - All work created by your team
- Files and documents - Uploaded files and attachments
- Custom settings - Workflows, fields, and preferences specific to your team
Think of an organization as a completely separate instance of Verk for your team - with its own members, projects, and data that nobody else can access.
Complete Data Separation
Each organization is completely isolated:
- Your data stays yours - Other organizations can't see your work
- Independent settings - Each workspace has its own configuration
- Separate billing - Each organization has its own subscription
- Private by default - Nothing is shared unless you explicitly invite people
Why Multiple Workspaces?
Common Scenarios
Different companies or clients:
- You run multiple businesses
- You're a consultant working with different clients
- You freelance for various companies
- You need complete separation between client work
Separating work types:
- Personal projects vs. business work
- Client work vs. internal operations
- Different departments in large companies
- Testing environment separate from production
Team independence:
- Each team manages their own space
- Different workflows for different purposes
- Separate billing and subscriptions
- Independent admin controls
Most people need just one organization for their team. Only create additional organizations when you truly need complete separation between workspaces.
Creating Your Organization
First-Time Setup
When you first sign up:
- Sign up for Verk with your email
- Verify your email address
- Create your organization:
- Organization name - Your company or team name
- Workspace URL - A unique identifier (like "acme-corp")
- Organization logo - Upload your logo (optional)
- Timezone - Your organization's primary timezone
- Click "Create Organization"
You're now the organization owner with full control.
Choosing Names
Organization name best practices:
- Use your company name - "ACME Corporation" or "Design Studio LLC"
- Or team name - "Marketing Team" or "Engineering Department"
- Be specific - "Jones Consulting - East Coast" instead of just "Consulting"
- Keep it professional - This appears in invitations and notifications
Workspace URL guidelines:
- Format: Part of your Verk URL
- Must be unique - Nobody else can use this identifier
- Permanent - Difficult to change later
- Professional - Use company name or abbreviation
Good workspace identifiers:
acme-corp- Company namedesignstudio- Business namejones-consulting-east- Specific team
Organization Structure
What Belongs to an Organization
Everything in your workspace:
Projects and tasks:
- All projects created in the organization
- Every task within those projects
- Task comments and collaboration
- Project analytics and reports
Team and permissions:
- Organization members
- Role assignments (Owner, Admin, Member, Guest)
- Project-specific permissions
- Access controls
Custom configuration:
- Custom fields and schemas
- Workflow statuses
- Integration connections
- Automation rules
Files and assets:
- Uploaded files and documents
- Shared assets and resources
- Organization logo and branding
Organization Roles
Owner - The person who created the organization or was transferred ownership
- Full control over everything
- Billing and subscription management
- Can delete organization
- Transfer ownership to another member
Admin - Trusted team members who help manage
- Manage members and permissions
- Configure organization settings
- Create and manage projects
- View analytics and reports
Member - Regular team members doing work
- Create and manage tasks
- Participate in assigned projects
- Collaborate with team
- View their own work and shared projects
Guest - External collaborators
- Access only specific invited projects
- Limited visibility into organization
- View and comment on assigned work
- Cannot see other organization data
Data Isolation and Security
How Data is Separated
Complete isolation between organizations:
- Separate databases - Your data is logically isolated
- No cross-contamination - Organizations can't accidentally see each other
- Independent backups - Each organization backed up separately
- Secure boundaries - Technical controls prevent data leakage
Privacy by Default
Your organization is private:
- Members only - Only invited people can access
- No discovery - Others can't find or search for your organization
- Controlled invitations - You decide who joins
- Revocable access - Remove members anytime
Data Ownership
You own your data:
- Full control - Export or delete anytime
- Your policies - Set your own retention rules
- Portable - Take your data with you if you leave
- No surprises - Clear terms about data ownership
Multiple Organizations
Working Across Workspaces
If you're in multiple organizations:
- One account - Single login for all workspaces
- Easy switching - Toggle between organizations instantly
- Independent context - Each workspace remembers your state
- Separate notifications - Control alerts per organization
When to Create Multiple
Create separate organizations for:
True business separation:
- Different companies you own
- Client workspaces (agency model)
- Personal vs. professional work
Department independence:
- Completely separate teams
- Different billing requirements
- Independent management
Testing and staging:
- Sandbox for trying features
- Training environment
- Development workspace
Don't create multiple for:
- Different projects in same company (use Projects instead)
- Different teams in same company (use project permissions)
- Temporary work (use project archiving)
Managing Your Organization
Organization Settings
Configure your workspace:
Basic information:
- Organization name and logo
- Description and industry
- Timezone and locale settings
- Date and time format preferences
Team management:
- Invite and remove members
- Assign roles and permissions
- View member directory
- Manage guest access
Security:
- Two-factor authentication requirements
- Session timeout settings
- Password policies
- Access controls
Billing:
- View current subscription
- Update payment methods
- See usage and limits
- Access invoices
Growing Your Organization
As your team expands:
Plan ahead:
- Choose plan with room to grow
- Organize project structure early
- Set up naming conventions
- Document how team uses Verk
Onboard effectively:
- Welcome message for new members
- Training resources and guides
- Project templates for consistency
- Clear role definitions
Maintain quality:
- Regular permission audits
- Remove inactive members
- Clean up old projects
- Review and update workflows
Best Practices
Organization Setup
Start strong:
- Clear naming - Professional, descriptive organization name
- Consistent branding - Use company logo and colors
- Plan structure - Think about project organization before inviting team
- Document guidelines - Create standards for how team uses Verk
Member Management
Build effective teams:
- Right roles - Give people appropriate permissions, not more
- Regular reviews - Audit member list quarterly
- Prompt offboarding - Remove former team members immediately
- Smooth onboarding - Help new members get started
Security
Protect your workspace:
- Enable 2FA - Require two-factor authentication for all members
- Review permissions - Check who has admin access regularly
- Limit guests - Only use guest access when truly needed
- Monitor activity - Watch organization activity logs
Data Management
Keep data organized:
- Archive completed projects - Move finished work out of active view
- Clean up regularly - Remove unnecessary tasks and files
- Export important data - Keep backups of critical information
- Follow retention policies - Delete data according to your policies
Understanding Multi-Tenancy
What Multi-Tenant Means
In simple terms: Each organization is like a completely separate installation of Verk, but they all share the same underlying system. You get the isolation of separate systems with the convenience of one account and one platform.
Benefits for you:
- Lower cost - Shared infrastructure means lower prices
- Easy management - One account, multiple workspaces
- Consistent experience - Same interface across all organizations
- Quick switching - Move between workspaces instantly
Technical Benefits (User Perspective)
What this means in practice:
- Always up-to-date - All organizations get new features simultaneously
- Reliable - Shared infrastructure means better uptime
- Scalable - Organizations grow without performance impact
- Integrated - Features work consistently across workspaces
Troubleshooting
Common Issues
Can't see organization:
- Check if you're logged into correct account
- Verify invitation was accepted
- Confirm you haven't been removed
- Try refreshing browser
Can't perform action:
- Check your role (might need admin)
- Verify organization subscription is active
- Ensure you have necessary permissions
- Contact organization owner
Organization seems wrong:
- Confirm you're in correct workspace
- Use organization switcher to change
- Check URL to verify current organization
Getting Help
If you need assistance:
- Contact support - We can help resolve issues
- Check your role - Verify you have necessary permissions
- Ask organization admin - They may need to adjust settings
- Review documentation - Other articles may help
Related Documentation
- Member Management - How to invite and manage team members
- Organization Settings - Configure your workspace
- Workspace Switching - Navigate between multiple organizations
- Projects - Organize work within your organization
Need help? Contact our support team or check our FAQ.