---
title: Groups
summary: 'A named collection of users in your PBX that the rest of the system can target as one team.'
section: features
tags:
  - crud
  - telephony
  - organization
updated: '2026-08-12'
related_forms:
  - phone_buttons
  - caller_identities
  - ai_prompts
---

> A **group** is a named collection of users the rest of the system can target as one team. Each user belongs to exactly one group at a time, which is the line between a group and a [tag](tags.md).

## Overview

A group is how you organize people into teams like *Sales*, *Support*, or *Reception*. Each user belongs to one group at a time. Groups act as routing targets across the system - queue members, multicast destinations, and *Dial group* call flow steps - so you can address a whole team at once.

## What it does

Beyond routing, a group can carry its own default call flows, outgoing caller identities, a shared contacts address book, phone buttons cascaded to every member's device, and a pickup scope so members can answer each other's ringing phones. Defaults set on the group are used instead of the PBX defaults, and adding a user to a group moves them out of their previous one.

> [!TIP]
> If you wish a user could be in two groups, make one of them a [Tag](tags.md) instead. Tags, [Pools](pools.md), [Locations](locations.md), and [Languages](languages.md) all allow multi-membership without the routing overhead of a group.

## See also

- [Users](users.md) - the group's members.
- [Call flows](call_flows.md) - the *Dial group* step.
- [Queues](queues.md) - groups as a member source.
- [Phone numbers](phone_numbers.md) - caller identities.
- [Phone buttons](phone_buttons.md) - cascaded buttons.
- [Pools](pools.md) - dynamic alternative.

```yaml fields
name:
  label: Name
  api: name
  tab: General
  hint: 'The display name of this group, shown throughout the system when selecting or referencing it.'
description:
  label: Comment
  api: description
  tab: General
  hint: 'An optional note about this group. You can edit this directly from the list view.'
defaultInternalCallFlow:
  label: 'Default internal call flow for group users'
  api: defaultInternalCallFlow
  tab: General
  hint: 'The call flow used by default for internal incoming calls to users in this group. Overrides the PBX-level default.'
defaultExternalCallFlow:
  label: 'Default external call flow for group users'
  api: defaultExternalCallFlow
  tab: General
  hint: 'The call flow used by default for external incoming calls to users in this group. Overrides the PBX-level default.'
users:
  label: Users
  api: users
  tab: General
  hint: 'The users who belong to this group. Each user can only belong to one group at a time.'
allow_call_pickups:
  label: 'Allow group call pickups'
  api: allow_call_pickups
  tab: General
  hint: 'When turned on, members of this group can pick up ringing calls from other group members by dialing the pickup code.'
allowManageGroupContacts:
  label: 'Allow managing group contacts for other users'
  api: allowManageGroupContacts
  tab: General
  hint: 'Users who are allowed to create, edit, and delete contacts that belong to this group.'
allowAccessToGroupContacts:
  label: 'Allow visibility to group contacts for other users'
  api: allowAccessToGroupContacts
  tab: General
  hint: "Users who can see and search the group's shared contacts without the ability to modify them."
allow_default_pbxes_outgoing_phone_numbers:
  label: 'Allow default outgoing phone numbers'
  api: allow_default_pbxes_outgoing_phone_numbers
  tab: 'Outgoing phone numbers'
  hint: 'When turned on, the PBX-level default outgoing phone numbers are available to users in this group alongside any group-specific phone numbers.'
extensionShownOutsideTheGroup:
  label: 'Extension shown outside the group'
  tab: 'Outgoing phone numbers'
  hint: "The extension number shown to external parties when a group member makes an outgoing call through the group's phone numbers."
callerIdentities:
  label: 'Phone numbers'
  api: callerIdentities
  tab: 'Outgoing phone numbers'
  hint: 'The outgoing phone numbers available to users in this group. Each entry maps a phone number with an optional extension suffix and label.'
defaultCallerIdentity:
  label: 'Default caller identity'
  tab: 'Outgoing phone numbers'
  hint: 'The default outgoing caller identity used when a group member makes an external call. If not set, the PBX default is used.'
display_tab_to_everyone_inside_voxbi:
  label: 'Display this group to everyone'
  api: display_tab_to_everyone_inside_voxbi
  tab: 'Voxbi apps'
  hint: 'When turned on, this group appears as a tab visible to all users in the Voxbi application.'
userVoxbiGroupTabs:
  label: 'Display to the following users'
  tab: 'Voxbi apps'
  hint: 'Specific users who will see this group as a tab in their Voxbi application, regardless of the global visibility setting.'
groupVoxbiGroupTabs:
  label: 'Display to the following groups'
  tab: 'Voxbi apps'
  hint: 'Members of these groups will see this group as a tab in their Voxbi application.'
phoneButtons:
  label: 'Phone buttons'
  tab: 'Phone buttons'
  hint: 'Phone buttons configured at the group level. These buttons are inherited by all SIP devices of users in this group.'
ai_prompt:
  label: Prompt
  tab: 'AI prompt'
  hint: 'Instructions the AI follows when handling calls for this group. Leave empty to remove the prompt. Only shown when the PBX is on an AI plan.'
```