> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contactship.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams and sub-teams

> Organize people into teams, configure leaders, default roles and calendars. Understand inheritance and what changes when members move.

export const Availability = ({lang = 'es', plan, addon, permission, route, status}) => {
  const L = lang === 'en' ? {
    plan: 'Plan',
    addon: 'Add-on',
    permission: 'Permission',
    route: 'Where',
    status: 'Status',
    addonNote: 'enabled on request',
    allPlans: 'All plans',
    beta: 'Beta',
    nuevo: 'New',
    soon: 'Coming soon'
  } : {
    plan: 'Plan',
    addon: 'Add-on',
    permission: 'Permiso',
    route: 'Dónde',
    status: 'Estado',
    addonNote: 'se activa a pedido',
    allPlans: 'Todos los planes',
    beta: 'Beta',
    nuevo: 'Nuevo',
    soon: 'Próximamente'
  };
  const items = [];
  if (plan) items.push([L.plan, plan]);
  if (addon) items.push([L.addon, `${addon} · ${L.addonNote}`]);
  if (permission) items.push([L.permission, permission]);
  if (route) items.push([L.route, route]);
  if (status) items.push([L.status, L[status] || status]);
  return <div style={{
    display: 'flex',
    flexWrap: 'wrap',
    gap: '6px 22px',
    padding: '12px 16px',
    margin: '4px 0 24px',
    border: '1px solid rgba(2, 82, 255, 0.28)',
    borderLeft: '3px solid #0252ff',
    borderRadius: '8px',
    background: 'rgba(2, 82, 255, 0.05)',
    fontSize: '13.5px',
    lineHeight: '1.5'
  }}>
      {items.map(([k, v]) => <div key={k} style={{
    display: 'flex',
    gap: '6px',
    alignItems: 'baseline'
  }}>
          <span style={{
    fontSize: '10.5px',
    fontWeight: 600,
    letterSpacing: '0.07em',
    textTransform: 'uppercase',
    opacity: 0.65
  }}>{k}</span>
          <span style={{
    fontWeight: 500
  }}>{v}</span>
        </div>)}
    </div>;
};

<Availability lang="en" route="Settings → Organization → Teams" permission="teams.read" />

Teams group people and can contain sub-teams. They support filtering, access scopes and work organization. Each person retains an individual role and can belong to more than one team.

## Create and organize

1. In **Teams**, click **New team**.
2. Enter a name and optional description.
3. Choose a **Parent team**, or leave it unset for a root team.
4. Review the **Default role**, create the team and add existing organization members.

Creating requires `teams.create`; editing, `teams.update`; deleting, `teams.delete`. The **Members** tab lists direct members, not people in sub-teams.

## Roles and leaders

| Setting                   | Effect                                                                         |
| ------------------------- | ------------------------------------------------------------------------------ |
| Default role              | Applies to future members; does not change existing members                    |
| Apply a role to this team | Changes selected direct members' roles; excludes sub-teams                     |
| Leader                    | Identifies team leadership; does not grant administrator permissions by itself |
| Remove from team          | Removes membership without removing the organization account                   |

When adding people, review the warning if a default role will replace another role. Bulk role application skips the owner and your own account.

## Working hours, holidays and time zone

The **Team calendar** defines working hours, holidays and time zone. Without its own calendar, a team inherits from its parent or organization. The routing clock uses this calendar.

## Move or delete

**Move** changes the parent and moves sub-teams with it. A team cannot move inside its own subtree.

The app blocks deletion while sub-teams or role-scope references depend on the team. Resolve the listed dependencies before trying again. Deleting a team does not delete its members or change their roles by itself.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Why are sub-team members missing from Members?">
    The list shows direct members only. Select a sub-team to view its own list.
  </Accordion>

  <Accordion title="Does changing the default role update everyone?">
    No. It affects new memberships. Use the role-application action for current members and review the recipients.
  </Accordion>

  <Accordion title="Why can I see a team but not its members’ names?">
    Viewing teams and viewing organization members require different permissions. Ask an administrator to review member read access.
  </Accordion>

  <Accordion title="Does every team need its own calendar?">
    No. Teams inherit from their parent or organization when no calendar is configured. Use a separate calendar for different hours or time zones.
  </Accordion>
</AccordionGroup>

## See also

* [Roles and permissions](/en/organization/roles-and-permissions)
* [Members](/en/organization/members)
* [Lead routing](/en/lead-routing/how-it-works)