Scheduling Teams Overview

Organize your workforce into location, department, and custom teams so every schedule, shift, and swap operates within the right group of people.

---

What Are Scheduling Teams?

Scheduling Teams let administrators define who belongs to which scheduling unit—by location, department, skill, or any custom criteria—and then use those teams as the backbone for schedule creation, shift assignment, and open-shift eligibility. Instead of manually curating shift rosters, teams resolve their members automatically from organizational data and keep memberships up to date in the background.

Core Value Proposition:

• 🎯 Targeted Scheduling — Assign shifts to the right people by scoping schedules to a specific team
• 🤝 Flexible Membership — Rule-based criteria (department, location, skills) or hand-picked members
• 📊 Always Current — Materialized membership tables refresh automatically so you never schedule the wrong person
• 💰 Bulk Operations — Create dozens of teams in seconds from your existing org structure

---

At a Glance

⏱️ Setup Time	🏷️ Team Types	🔄 Swap Scopes	📱 Mobile Ready
2 minutes	3 (Location, Department, Custom)	3 (Same Team, Same Location, Any)	✅ Yes

Perfect For:

• 🏢 Multi-location businesses — Auto-create a team per site so shifts stay location-specific
• 👥 Department-based scheduling — One team per department with membership derived from HR data
• 📈 Cross-functional teams — Combine departments, locations, and skills into custom teams

---

How It Works

Team Resolution Flow

┌─────────────────────────────────────────────────────────────────────────┐
│                    SCHEDULING TEAM MEMBERSHIP                          │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   ┌──────────────┐    ┌──────────────┐    ┌──────────────┐             │
│   │  DEFINE TEAM │───▶│ RESOLVE      │───▶│ USE IN       │             │
│   │  (Rules or   │    │ MEMBERS      │    │ SCHEDULING   │             │
│   │  Specific)   │    │ (Auto)       │    │              │             │
│   └──────────────┘    └──────────────┘    └──────────────┘             │
│         │                    │                    │                     │
│         ▼                    ▼                    ▼                     │
│   Location, Dept,     4-Layer Cache:       Shifts, Schedules,          │
│   Skills, or          Request → Materialized Swaps & Claims            │
│   Hand-Picked         → TTL → Live SQL                                 │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Integration Ecosystem

                         ┌──────────────────┐
                         │ SCHEDULING TEAMS │
                         └────────┬─────────┘
                                  │
       ┌──────────┬───────────────┼──────────────┬──────────────┐
       ▼          ▼               ▼              ▼              ▼
 ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐
 │ Schedules │ │  Shifts   │ │  Swap /   │ │  Notifi-  │ │ Locations │
 │           │ │           │ │  Claims   │ │  cations  │ │ & Depts   │
 └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘

---

Key Features

🏷️ Three Team Types

Scheduling Teams come in three flavors, each suited to different organizational needs:

Type	How Members Are Determined	Auto-Managed?
Location	All users assigned to a physical location	✅ Yes — synced from location data
Department	All users in an organizational department	Rule-based, auto-derived
Custom	Any combination of departments, locations, skills, or hand-picked users	Rule-based or specific users

Use Case: A hospital might use Location teams for each campus, Department teams for nursing vs. radiology, and a Custom team for a cross-campus night-shift rotation that requires specific certifications.

---

⚡ Quick Setup — Bulk Team Creation

Create teams at scale from your existing organizational data without manual entry:

Quick Setup Option	What It Creates	Example
Per Department	One team per active org department	Engineering, Marketing, Operations
Per Location	One team per active physical location	Downtown Office, Warehouse A
Per Location × Department	One team for each department at each location	Engineering — Downtown, Marketing — Warehouse A

Each option shows a preview of teams to be created before you confirm, and automatically skips teams that already exist.

Auto-Create Toggles: Enable auto-creation so new departments or locations automatically get their own scheduling team — no admin intervention needed.

---

🔧 Rule-Based & Specific-User Membership

Teams support two membership modes:

Rule-Based (AND logic):
Combine up to three criteria types. Members must match all specified rules:

Rule Type	Operator	Example
Department	is	“Engineering”
Locations	is any of	“Downtown” or “Midtown”
Skills / Certificates	includes any of	“Forklift License”, “First Aid”

Specific Users:
Hand-pick individual team members when rules don’t fit your use case.

💡 Pro Tip: The team type (Department vs. Custom) is automatically derived from your rules — you never have to pick it manually. A single department rule creates a Department team; any other combination creates a Custom team.

---

🔄 Swap Scope — Shift Eligibility Control

Each team has a Swap Scope setting that determines who can pick up or swap shifts assigned to that team:

Swap Scope	Who Can Claim/Swap	Best For
Same Team	Only members of this specific team	Strict role separation
Same Location	Anyone at the same physical location	Location-flexible roles
Any (Unrestricted)	Any eligible employee in the business	Maximum coverage flexibility

This integrates directly with the shift claim and swap system — when an employee tries to claim an open shift, the system checks the team’s swap scope to determine eligibility.

---

👥 Member Management

Materialized Membership Table

Team memberships are pre-computed and stored in a materialized table for fast lookups. The system uses a 4-layer resolution path (checked in order, first hit wins):

1. Request-scoped memo — Zero DB cost, auto-reset per request
2. Materialized table — Indexed read from pre-computed data (refreshed every 6 hours)
3. TTL cache — 5-minute cached ID array
4. Live SQL resolution — Single query with JOINs as fallback

Manual Overrides

Even with rule-based teams, you can override membership for individuals:

Override	Effect
Manual Include	Force-add a user who doesn’t match the rules
Manual Exclude	Remove a user who does match the rules

Refresh Members

Use the Refresh Members action from the index page to trigger a full membership recalculation across all active teams, with a live progress bar.

---

🏗️ Parent-Child Team Hierarchy

Teams can be organized into a hierarchy by setting a Parent Team:

• Sub-teams appear as tabs in the schedule view
• Useful for organizing large departments into sub-units (e.g., “Engineering” parent with “Frontend”, “Backend”, “DevOps” children)
• Parent must belong to the same business
• Only root-level (top-level) teams can be selected as parents

---

👔 Manager & Co-Manager Assignment

Each team supports dedicated management roles:

Role	Description
Primary Manager	Single designated manager for the team
Co-Managers	Additional managers who share oversight
Derived Managers	Automatically pulled from location manager assignments

If no explicit manager is assigned, managers are derived from the team’s associated locations.

---

📥 CSV Import / Export

Manage teams in bulk through CSV:

Export: Download all teams as a CSV with columns for id, name, group_type, active, swap_scope, description, parent_team, and manager_email.

Import Workflow:

1. Export your current teams
2. Edit the CSV in Excel or Google Sheets
3. Import the edited file — existing teams matched by id are updated; rows without an id create new teams

The import modal includes a live file preview before submission.

---

🔍 Filtering & Search

The teams index page provides powerful filtering:

Filter	Options
Search	Free-text search by team name
Type	All Types, Location, Department, Custom
Status	All, Active, Inactive

Results are paginated (25 per page) and sortable.

---

📊 Team Statistics

The index table displays key metrics for each team at a glance:

Metric	Description
Members	Count of resolved team members (clickable to view list)
Status badges	Active/Inactive, In Use (upcoming shifts), Past Only
Type badge	Location, Department, or Custom
Location info	Associated locations displayed inline
Manager	Assigned manager name

---

🔗 Integrations

Scheduling Teams are the connective tissue between organizational data and shift operations:

Integration	How It Works
Shifts	Each shift can be scoped to a scheduling team; the team determines eligible assignees and swap candidates
Schedules	Schedules can be associated with a team for team-specific schedule views
Shift Claims	The team’s swap scope controls who can claim open shifts
Notifications	Shift notifications use the team name as context for non-location teams
Locations	Location teams are auto-synced; location changes auto-update the team
Departments	Department teams derive membership from org department assignments
Skills	Custom teams can require specific skills or certifications

---

🔔 Notifications

Type	Description
Shift Assignment	Notifications display the scheduling team name as context for department and custom teams
Shift Claim	Claim notifications use team context (team name for non-location teams, location name otherwise)

---

📋 Audit Trail

All scheduling team changes are tracked with Paper Trail versioning:

• Team creation, updates, and deletions are logged
• Each version records the business context
• Useful for compliance and troubleshooting membership changes

---

User Roles & Permissions

Role	Capabilities
Admin / Super Admin	Full CRUD on all teams, Quick Setup, bulk operations, CSV import/export, auto-create toggles, refresh members
Manager	View teams they manage, see member lists
Employee	See their team assignment via shifts and schedules

---

How We Compare

See how MangoApps Workforce Scheduling Teams stack up against leading workforce management solutions:

Feature	MangoApps Workforce	UKG (Kronos)	When I Work	Deputy
Location-based teams	✅	✅	✅	✅
Department-based teams	✅	✅	✅	✅
Custom rule-based teams	✅	✅	❌	❌
Skills-based membership	✅	✅	❌	❌
Bulk team creation from org data	✅	❌	❌	❌
Auto-create on new dept/location	✅	❌	❌	❌
CSV import/export	✅	✅	❌	❌
Configurable swap scope per team	✅	⚡ Limited	✅	✅
Parent-child team hierarchy	✅	✅	❌	❌
Materialized membership (performance)	✅	✅	❌	❌

Legend: ✅ Included

❌ Not Available

⚡ Limited

Why MangoApps Workforce?

• 🔗 Unified Platform — Scheduling Teams work seamlessly with Shifts, Schedules, Locations, and Skills in one system
• 💰 No Hidden Costs — All team features included, no per-module pricing
• ⚡ Quick Setup — Bulk-create teams from org data in seconds, not hours of manual configuration

---

Getting Started

For Administrators

1. Navigate to Admin → Scheduling Teams (/admin/businesses/{id}/scheduling_groups)
2. Use Quick Setup to bulk-create teams from your existing departments and locations
3. Enable Auto-Create toggles so new departments/locations get teams automatically
4. Review teams in the table — edit swap scope, assign managers, and configure membership rules as needed
5. Use Refresh Members to trigger an immediate membership recalculation

For Managers

1. Your assigned teams appear in the schedule and shift views
2. When creating schedules, select a scheduling team to scope the schedule
3. Member lists for your teams are available via the member count link on the teams page

For Employees

1. Your team membership is automatic — based on your location, department, and skills
2. Open shifts available to you are filtered by your team’s swap scope
3. Check My Shifts to see shifts assigned through your scheduling team

---

Best Practices

• ✅ Start with Quick Setup — Bulk-create teams from departments and locations before creating custom teams
• ✅ Enable Auto-Create — Turn on auto-creation toggles so new org units get teams without manual work
• ✅ Use rule-based membership — Let membership derive from org data rather than hand-picking users; rules stay current automatically
• ✅ Set appropriate swap scopes — Use “Same Team” for role-specific shifts, “Same Location” for flexible roles, and “Any” sparingly
• ✅ Assign managers explicitly — While managers are auto-derived from locations, explicit assignment gives clearer ownership
• ✅ Review members after org changes — Use Refresh Members after large HR changes (reorgs, bulk hires) to ensure accuracy

---

Frequently Asked Questions

Q: How are location teams different from other teams?
A: Location teams are auto-managed — they’re created automatically from your Locations data and cannot be deleted. Their name syncs from the location, and members are all users assigned to that location. You can still edit their description, swap scope, and parent team.

Q: What happens when I add a new department or location?
A: If you’ve enabled the Auto-Create toggle for that team type, a corresponding scheduling team is created automatically. Otherwise, you can use Quick Setup to create it manually.

Q: Can a user be in multiple scheduling teams?
A: Yes. Users can belong to multiple teams — for example, a user at the “Downtown” location in the “Engineering” department would be in both the Downtown location team and the Engineering department team.

Q: How often are team memberships refreshed?
A: Memberships refresh automatically when a team is created or updated, and a background job rechecks stale teams (older than 1 hour) periodically. You can also trigger an immediate refresh from the Actions menu.

---

Related Resources

• Shifts & Scheduling Help Index — Complete guide to shift and schedule management
• Shift Creation FAQ — How to create and assign shifts
• Schedule Templates FAQ — Reusable schedule templates
• Schedule Conflicts FAQ — Understanding and resolving conflicts
• Availability Management FAQ — Employee availability settings

---

Scheduling Teams — the foundation for organized, accurate, and efficient workforce scheduling.