Organizations

What are Organizations?

Organizations are the foundation of collaboration on FairArena. They represent companies, open-source communities, professional groups, or any collective where teams work together on projects.

🏢

For Companies

Manage your entire workforce and projects

🌐

For Communities

Build open-source and interest groups

🎓

For Institutions

Educational and research collaboration

Organization Structure

Understanding how organizations work:

Component	Description	Purpose
Organization	Top-level entity	Main container for all collaboration
Teams	Work groups within org	Focused collaboration spaces
Projects	Work items within teams	Specific deliverables and tasks
Roles	Permission sets	Control access and capabilities
Members	People in the org	Users with assigned roles

Finding Organizations

Browse Available Organizations

Access Organizations Page

Navigate to Organizations from your dashboard

Filter Organizations

Use filters to find what you need:

Filter	Description	Use Case
Visibility	Public/Private	Find open organizations
Industry	Organization type	Match your interests
Size	Member count	Small teams vs large corps
Activity	Recent activity	Active communities

View Organization Details

Click any organization to see:

Organization profile and description
Number of teams and members
Recent activity
Public projects
Join options

Search Organizations

Use the search bar to find specific organizations by name or keywords

Organization Visibility

Characteristics:

✅ Visible to everyone (even non-members)
✅ Appear in search results
✅ Anyone can request to join
✅ Great for open-source communities
✅ Maximum discoverability

Best for:

Open-source projects
Public communities
Educational institutions
Networking groups

Characteristics:

🔒 Only visible to members
🔒 Invitation-only
🔒 Don't appear in public search
🔒 Better security and privacy
🔒 Controlled access

Best for:

Private companies
Confidential projects
Internal teams
Client work

Creating an Organization

Planning Your Organization

Before creating, consider:

Decision	Options	Impact
Purpose	Company, Community, Project	Shapes structure
Visibility	Public or Private	Who can see it
Size	Small team or Enterprise	Resource needs
Structure	Teams and roles	How people work

Navigate to Creation

Go to Organizations → Create Organization

Set Basic Information

Organization Name

Clear and memorable
Represents your organization well
Example: "Acme Corp", "React Developers"

Slug

URL-friendly identifier
Auto-generated from name
Can be customized
Example: "acme-corp", "react-devs"

Write Description

Create a compelling description:

What your organization does
Who should join
What to expect
Main goals and values

Example:

Acme Corp is a leading software development company specializing in 
cloud solutions. We build scalable applications using modern technologies 
and welcome developers passionate about innovation.

Upload Branding

Logo

Recommended size: 200x200px
Formats: PNG, JPG, SVG
Appears on profile and in listings

Banner

Recommended size: 1200x400px
Creates visual impact
Appears on organization page

Configure Settings

Visibility Settings:

☑️ Public (visible to all)
☐ Private (members only)

Join Settings:

☑️ Enable open join
☐ Invitation only

Other Settings:

Set timezone
Add location
Add website URL

Create Initial Roles

Set up role structure (you can modify later):

Role	Permissions	Suggested For
Owner	Full control	Founders
Admin	Manage most things	Leadership team
Member	Basic access	Regular employees
Viewer	Read-only	Contractors, observers

Invite Initial Members

Add your first team members:

Enter email addresses
Assign roles
Send invitations

Launch!

Click Create Organization and you're live! 🚀

Organization Features

Organization Profile

Your organization's public face:

Profile Sections:

Following Organizations

Stay connected without joining:

How Following Works:

Action	Effect
Follow	Get updates from the organization
Notifications	Receive announcements
Dashboard	See activity in your feed
Visibility	Organization sees follower count

To Follow:

Visit organization profile
Click Follow button
Receive updates on your dashboard
Unfollow anytime

Following is different from joining. Followers get updates but don't have member access.

Starring Organizations

Show appreciation:

Click the ⭐ Star button
One-time recognition
Appears on organization profile
Helps others discover quality orgs
Can unstar anytime

When to star:

Organization you find valuable
Quality projects and community
Impressive work
Good practices

Organization Audit Logs

Track important events (Admin/Owner only):

Logged Events:

Member additions/removals
Role changes
Settings updates
Team creation/deletion
Project changes
Security events

Log Details:

Who performed the action
What changed
When it happened
Additional metadata

Access logs: Settings → Audit Logs → View History

Managing Your Organization

Member Management

Adding Members:

Go to Organization Settings
Click Members → Invite
Enter email addresses (one per line)
Select role for invitees
Add personal message (optional)
Click Send Invitations

Recipients receive email with join link.

Go to Organization Settings
Click Invite Codes → Create
Select role for code
Set expiration date
Optional: Specify email
Click Generate Code
Share code with invitee

Code can be used once before expiring.

Go to Organization Settings
Enable Open Join
Set default role for new members
Save settings

Anyone can now join instantly!

Removing Members:

Go to Members list
Find the member
Click options menu (⋯)
Select Remove from Organization
Confirm removal

Removing a member also removes them from all teams and projects within the organization.

Role Management

Viewing Members by Role:

Role	View	Actions
All Members	See everyone	Filter by role
By Role	See specific role group	Bulk role changes
By Team	Members per team	Team-based management

Changing Member Roles:

Navigate to Members
Find the member
Click Change Role
Select new role
Confirm change

Creating Custom Roles:

Go to Settings → Roles
Click Create Role
Name the role
Select permissions:
- ☑️ Manage members
- ☑️ Create teams
- ☑️ Manage settings
- ☑️ View audit logs
- ☑️ Manage billing
- And more...
Save role

Organization Roles & Permissions

Standard Roles Explained

Highest level of control

Can:

✅ Delete the organization
✅ Transfer ownership
✅ Manage all settings
✅ Add/remove members (including admins)
✅ Assign any role
✅ Manage billing
✅ View audit logs
✅ Everything admins can do

Limits:

Only one owner per organization
Can transfer to another member

Best for: Founders, CEO

High level of control

Can:

✅ Manage organization settings
✅ Create and manage teams
✅ Invite members
✅ Assign roles (except owner)
✅ Remove members (except owner)
✅ Configure team settings
✅ View audit logs

Cannot:

❌ Delete organization
❌ Remove owner
❌ Assign owner role
❌ Transfer ownership

Best for: Leadership team, managers

Standard access

Can:

✅ View organization information
✅ Join teams (if allowed)
✅ Participate in projects
✅ View other members
✅ Create teams (if allowed)
✅ Follow and star

Cannot:

❌ Change organization settings
❌ Manage members
❌ Assign roles
❌ Delete teams/projects

Best for: Regular employees, contributors

Read-only access

Can:

✅ View organization profile
✅ See public teams/projects
✅ View member list
✅ Follow the organization

Cannot:

❌ Participate in teams
❌ Create projects
❌ Change anything
❌ Access private content

Best for: Contractors, observers, auditors

Permission Matrix

Complete permissions breakdown:

Permission	Owner	Admin	Member	Viewer
View organization	✅	✅	✅	✅
Edit organization profile	✅	✅	❌	❌
Delete organization	✅	❌	❌	❌
Invite members	✅	✅	❌	❌
Remove members	✅	✅	❌	❌
Assign roles	✅	✅*	❌	❌
Create teams	✅	✅	⚠️**	❌
Delete teams	✅	✅	❌	❌
Manage billing	✅	⚠️***	❌	❌
View audit logs	✅	✅	❌	❌
Create projects	✅	✅	✅	❌
Join teams	✅	✅	✅	❌

*Cannot assign Owner role
**If setting enabled
***If given billing permission

1. Clear Structure: Define roles and teams clearly
2. Regular Updates: Keep profile and info current
3. Active Management: Review members and permissions regularly
4. Communication: Use announcements for important updates
5. Security: Enable 2FA requirements for members
6. Documentation: Maintain internal docs and guidelines

Organization Naming

Good names:

✅ Clear and memorable
✅ Represents your purpose
✅ Professional
✅ Unique

Avoid:

❌ Generic names (e.g., "Team")
❌ Special characters
❌ Too long or complex
❌ Confusing abbreviations

Member Onboarding

Create a smooth onboarding experience:

Welcome Message: Send personalized welcome
Documentation: Share guidelines and resources
Initial Team: Assign to appropriate team
Buddy System: Pair with experienced member
First Tasks: Give clear initial assignments

Troubleshooting

Next Steps

Now that you understand organizations:

Need help with your organization? Contact Support →

Organizations

For Companies

For Communities

For Institutions

1. Open Join (Instant Access)

2. Invitation Code (Secure Access)

3. Request Access (Approval Required)

Basic Information

Statistics

Teams & Projects

Social

General Settings

Privacy & Access

Team Settings

Notifications

Security

Can't create organization

Invite codes not working

Can't remove member

Organization not showing in search

On this page