FairArena Logo
FairArena

Teams

Collaborate effectively within teams on FairArena

What are Teams?

Teams are focused collaboration groups within organizations. They bring together people working on related projects and goals, providing structure, access control, and a dedicated workspace.

🎯 Why Teams?

  • • Focused collaboration spaces
  • • Granular access control
  • • Project organization
  • • Role-based permissions

✨ Team Benefits

  • • Dedicated workspace
  • • Custom branding
  • • Member management
  • • Audit trail

Team Hierarchy

Understanding the structure:

Organization
  └── Team 1
       ├── Project A
       ├── Project B
       └── Members (with roles)
  └── Team 2
       ├── Project C
       └── Members (with roles)
LevelDescriptionExample
OrganizationTop container"Acme Corp"
TeamFocused group"Engineering Team"
ProjectSpecific work"Website Redesign"
MembersPeople with rolesDevelopers, Designers

Finding Teams

Browse Teams in Your Organization

Go to your Organization → Teams tab

View Available Teams

See all teams you can access:

Team TypeDescriptionAccess
PublicVisible to everyoneAnyone can request to join
InternalOrganization members onlyOrg members can request
PrivateMembers onlyInvitation required

Filter Teams

Use filters to find specific teams:

  • By visibility (Public/Private/Internal)
  • By activity (Most active)
  • By size (Number of members)
  • By your membership status

Search Teams

Use search to find teams by name or description

Team Visibility

Choose who can see and access your team:

✅ Maximum Visibility

Who can see:

  • ✅ Anyone on the internet
  • ✅ Organization members
  • ✅ Non-members

Who can join:

  • Anyone can request access
  • Open join available (optional)

Best for:

  • Open-source projects
  • Community teams
  • Public initiatives
  • Marketing/outreach teams

Considerations:

  • All content is public
  • Anyone can see members
  • Projects may be visible

✅ Organization-Only

Who can see:

  • ✅ Organization members only
  • ❌ External users
  • ❌ Non-members

Who can join:

  • Organization members can request
  • Encourages cross-team collaboration

Best for:

  • Most teams
  • Cross-functional work
  • Company-wide initiatives
  • General collaboration

Considerations:

  • Balanced privacy
  • Encourages internal networking
  • Good default choice

✅ Maximum Privacy

Who can see:

  • ✅ Team members only
  • ❌ Other org members
  • ❌ External users

Who can join:

  • Invitation only
  • No public requests

Best for:

  • Sensitive projects
  • Executive teams
  • Security/compliance work
  • Confidential initiatives

Considerations:

  • Complete privacy
  • Reduced discoverability
  • Manual member management

Joining Teams

Three Ways to Join

Creating a Team

Prerequisites

Before creating a team:

RequirementDescription
Organization MemberMust be in an organization
PermissionNeed team creation permission
PurposeClear goal for the team
StructurePlan for roles and members

Creation Process

Initiate Creation

Organization → TeamsCreate Team

Basic Information

Team Name

  • Clear and descriptive
  • Represents the team's purpose
  • Example: "Engineering Team", "Marketing Squad"

Team Slug

  • URL-friendly identifier
  • Auto-generated from name
  • Customizable
  • Example: "engineering-team", "marketing"

Description

  • Explain team's purpose
  • What projects team handles
  • Who should join
  • Team goals and focus

Set Visibility

Choose team visibility:

  • Public - Visible to everyone
  • Internal - Organization members only (recommended)
  • Private - Members only

Join Settings

Configure access:

  • Enable Open Join - Anyone can join instantly
  • Require Approval - Manual approval for join requests

Branding & Identity

Team Logo

  • Recommended: 200x200px
  • Formats: PNG, JPG, SVG
  • Represents team visually

Team Banner

  • Recommended: 1200x400px
  • Appears on team page
  • Creates visual impact

Additional Details:

  • Location (optional)
  • Website URL
  • Timezone

Create Roles

Define team roles:

RoleLevelTypical Permissions
Team OwnerHighestFull control
Team AdminHighManage most things
Team MemberStandardContribute to work
ViewerRead-onlyView content only

Invite Initial Members

Add your first team members:

  1. Enter email addresses
  2. Assign roles
  3. Send invitations

Launch Team

Click Create Team - your team is live! 🚀

Team Features

Team Profile

Your team's identity:

Team Audit Logs

Track all team activities (Admin/Owner):

Logged Events:

Event TypeDescriptionInformation Captured
Member ChangesAdd/remove membersWho, when, role
Role UpdatesRole assignmentsOld role, new role
Project ActionsCreate/delete projectsProject details
Settings ChangesTeam settings updatesWhat changed
InvitationsInvite codes created/usedBy whom, for whom

Access Audit Logs: Team Settings → Audit Logs → View History

Managing Your Team

Member Management

Via Email Invitation:

  1. Team Settings → Members → Invite
  2. Enter email addresses (one per line)
  3. Select role
  4. Add message (optional)
  5. Send invitations

Via Invite Code:

  1. Team Settings → Invite Codes
  2. Create Code
  3. Set role and expiration
  4. Generate and share

Via Open Join:

  1. Team Settings → Access
  2. Enable "Open Join"
  3. Set default role
  4. Save settings

View by Role:

  • Filter members by role
  • See role distribution
  • Identify permission gaps

Change Roles:

  1. Navigate to Members
  2. Find member
  3. Click options (⋯)
  4. Select "Change Role"
  5. Choose new role
  6. Confirm

Bulk Role Changes:

  1. Select multiple members
  2. Click "Bulk Actions"
  3. "Change Roles"
  4. Select new role
  5. Apply to all selected

Individual Removal:

  1. Members list
  2. Find member
  3. Options (⋯) → Remove
  4. Confirm removal

Effects of Removal:

  • Loses team access
  • Removed from team projects
  • Can't view private content
  • Can request to rejoin (if allowed)

Note: Member stays in organization

Team Settings

Configure your team:

Team Roles & Permissions

Role Comparison

PermissionTeam OwnerTeam AdminTeam MemberViewer
View team
View projects
Create projects
Edit team profile
Invite members⚠️*
Remove members
Assign roles✅**
Delete team
Manage settings
View audit logs
Delete projects

*If permission granted
**Cannot assign owner role

Role Details

Full control over team

Responsibilities:

  • Strategic direction
  • Team structure
  • Critical decisions
  • Member oversight

Unique Powers:

  • Delete team
  • Transfer ownership
  • Override any decision

Best for:

  • Team founders
  • Department heads
  • Project leads

Day-to-day management

Responsibilities:

  • Member management
  • Project oversight
  • Settings configuration
  • Access control

Limitations:

  • Can't delete team
  • Can't assign owner role
  • Can't remove owner

Best for:

  • Team managers
  • Senior members
  • Project coordinators

Active contributor

Capabilities:

  • Work on projects
  • Create projects (usually)
  • Collaborate with team
  • View team content

Limitations:

  • Can't manage team
  • Can't change settings
  • Limited admin access

Best for:

  • Regular team members
  • Contributors
  • Developers/designers

Read-only observer

Access:

  • View team information
  • See projects
  • Read content
  • Monitor progress

Limitations:

  • Can't contribute
  • Can't create projects
  • Can't edit anything

Best for:

  • Stakeholders
  • Observers
  • Auditors
  • External reviewers

Team Invitations

Creating Invite Codes

Generate secure team invitations:

Team Settings → Invite Codes → Create Code

Configure Code

SettingOptionsDescription
RoleOwner, Admin, Member, ViewerDefault role for invitee
Expiration1-90 days or customWhen code expires
EmailOptionalRestrict to specific email
Max Uses1, 5, 10, unlimitedHow many times code can be used

Generate & Share

  1. Click Generate Code
  2. Copy invite link
  3. Share via email, chat, etc.
  4. Track code usage

Monitor Codes

View all active codes:

  • See usage count
  • Check expiration
  • Revoke if needed
  • Generate new codes

Invite Code Best Practices

Security:

  • ✅ Set expiration dates
  • ✅ Limit to specific emails when possible
  • ✅ Use single-use codes for sensitive teams
  • ✅ Revoke unused codes regularly

Organization:

  • ✅ Name codes descriptively
  • ✅ Track who codes are sent to
  • ✅ Monitor code usage
  • ✅ Clean up expired codes

Team Best Practices

Team Structure

Organizing Teams

By Function: Engineering, Marketing, Sales
By Product: Product A Team, Product B Team
By Geography: APAC Team, EMEA Team, Americas Team
By Initiative: Launch Team, Research Team
Hybrid: Engineering-Product A, Marketing-Product B

Effective Team Management

Do:

  • ✅ Define clear team purpose
  • ✅ Set appropriate visibility
  • ✅ Assign roles thoughtfully
  • ✅ Keep member list current
  • ✅ Regular team updates
  • ✅ Use audit logs for accountability
  • ✅ Establish team norms

Don't:

  • ❌ Make too many teams
  • ❌ Overly complex structure
  • ❌ Ignore inactive members
  • ❌ Set wrong visibility
  • ❌ Forget to update info

Team Communication

Effective Practices:

  1. Regular Updates: Keep team informed
  2. Clear Roles: Everyone knows their responsibility
  3. Open Communication: Encourage questions
  4. Documentation: Maintain team docs
  5. Recognition: Celebrate achievements

Troubleshooting

Next Steps

Now that you understand teams:


Need help with teams? Contact Support →

On this page