Organizations
Multi-tenant organization management system
Organizations
Multi-tenant organizations are already built and working. Just create your first organization and start using it in your product.
The entire organization system, roles, teams, invitations, permissions are ready to use. No extra setup required.
How It Works
Organizations let you group users for collaboration. Everything is pre-configured:
- Has its own members with different roles
- Can be divided into teams
- Has organization-scoped billing through Autumn (per-seat pricing)
- Maintains its own settings and data
Creating an Organization
- Click your profile dropdown
- Select "Create Organization"
- Enter organization name
- Upload logo (optional)
- Click create
You'll be automatically added as the owner.
Organization Roles
Default Roles
Owner
- Full control over organization
- Manage all settings
- Delete organization
- Cannot be removed
Admin
- Manage members and roles
- Edit organization settings
- Cannot delete organization
Member
- Basic access to organization
- View content and collaborate
- Cannot manage settings
Custom Roles
Create custom roles at /organizations/[slug]/roles:
- Click "Create Role"
- Enter role name and description
- Select permissions
- Assign to members
Custom roles let you fine-tune access control for your specific needs.
Managing Members
Invite Members
At /organizations/[slug]/members:
- Click "Invite Member"
- Enter email address
- Select role(s)
- Send invitation
Invitation Process:
- User receives email invitation
- Clicks link to accept
- Added to organization with assigned roles
- Can decline invitation
View Members
See all members at /organizations/[slug]/members:
- Member name and email
- Assigned roles
- Join date
- Actions (edit role, remove)
Edit Member Roles
- Find member in list
- Click edit icon
- Select/deselect roles
- Save changes
Remove Members
- Find member in list
- Click remove button
- Confirm removal
- Member loses access immediately
Removing a member doesn't delete their account, just removes them from this organization.
Teams
Organize members into teams for better collaboration.
Create a Team
At /organizations/[slug]/teams:
- Click "Create Team"
- Enter team name
- Add description (optional)
- Click create
Add Team Members
- Go to team page
- Click "Add Member"
- Select from organization members
- Assign team role
- Add to team
Team Management
Each team has its own:
- Member list
- Settings
- Access control
- Collaboration space
Organization Settings
Manage settings at /organizations/[slug]/settings:
General Settings
Organization Name
- Change organization display name
- Must be unique across your instance
Organization Logo
- Upload custom logo
- Shown in navigation and profiles
- Automatic resizing
Organization Slug
- URL-friendly identifier
- Used in routes
- Cannot be changed after creation
Danger Zone
Delete Organization
- Scroll to danger zone
- Click "Delete Organization"
- Enter organization name to confirm
- Confirm deletion
Deleting an organization is permanent! All data, members, and teams are removed.
Member Invitations
Pending Invitations
View at /organizations/[slug]/invitations:
- See all pending invites
- Resend invitations
- Cancel invitations
- View invitation status
Accepting Invitations
As a user, view your invitations at /account/invitations:
- See all pending invites
- Click "Accept" to join
- Click "Decline" to reject
- Invitations highlighted when viewing
Billing
Organizations use per-seat pricing through Autumn. Each organization gets on a Pro plan and is automatically charged per user in the org.
Current Plan
- View active Pro subscription
- See current member count
- Check per-user pricing
- View billing cycle and renewal
Member Management & Billing
When you add members to an organization:
- Billing automatically adjusts
- Per-user charges apply immediately
- No manual plan changes needed
- Transparent pricing per member
Order History
- View past invoices
- Download receipts
- See payment history
- Track per-user charges
Billing is automatic through Autumn. Organizations are charged per user on the Pro plan.
Organization Switcher
Switch between organizations quickly:
- Click organization name in sidebar
- View list of all your organizations
- Click to switch
- Or create new organization
Routes
| Route | Purpose |
|---|---|
/organizations | Your organizations list |
/organizations/[slug] | Organization dashboard |
/organizations/[slug]/members | Member management |
/organizations/[slug]/invitations | Invitation management |
/organizations/[slug]/teams | Teams overview |
/organizations/[slug]/teams/[id] | Specific team |
/organizations/[slug]/roles | Custom roles |
/organizations/[slug]/settings | Organization settings |
/organizations/[slug]/billing | Billing (if enabled) |
/account/invitations | Your pending invitations |
Permissions System
The RBAC (Role-Based Access Control) system controls what members can do:
Organization-Level Permissions
- View organization
- Edit organization settings
- Manage members
- Manage teams
- Manage roles
- View billing
- Manage billing
- Delete organization
Team-Level Permissions
- View team
- Edit team
- Add members
- Remove members
- Manage team settings
Permissions are checked on every request. Unauthorized actions return 403 Forbidden.
Best Practices
For Organization Owners
- Set Clear Roles: Define what each role can do
- Use Teams: Organize members logically
- Regular Audits: Review members and permissions
- Secure Invitations: Only invite known email addresses
- Custom Roles: Create specific roles as needed
For Members
- Accept Invites Promptly: Check your email regularly
- Report Issues: Contact admins if access problems occur
- Use Teams: Collaborate within your team
- Respect Permissions: Don't attempt unauthorized actions
Troubleshooting
Can't Create Organization?
- Check you're signed in
- Verify email is confirmed
- Contact admin if restricted
Invitation Not Received?
- Check spam folder
- Verify correct email was entered
- Request resend from organization admin
Missing Permissions?
- Check your assigned roles
- Contact organization admin
- Review organization settings
Can't Switch Organizations?
- Verify you're a member
- Try refreshing the page
- Check organization still exists