A way to group related tags. For example you could have a “Life Stage” tag group with tags like “Child”, “Teen”, “Adult”, etc.
| Property | Value |
|---|---|
| Product | Groups (pco.groups, API version 2026-11-10) |
| Resource type | TagGroup |
| TypeScript | Groups.TagGroup, attributes Groups.TagGroupAttributes, schema Groups.TagGroupSchema |
| Planning Center path | /groups/v2/tag_groups |
| Planning Center docs | TagGroup |
How to reach it
| Client path | Returns | Filters | Create |
|---|---|---|---|
pco.groups.tag_groups |
Collection | public |
No |
From a collection, .id(tagGroupId) addresses one TagGroup: pco.groups.tag_groups.id(tagGroupId). Collections support where, include, order, and pagination; single resources have get().
Attributes
On Groups.TagGroupAttributes. Every resource also has id and type ('TagGroup') next to its attributes.
| Name | Type | Description |
|---|---|---|
display_publicly |
boolean | null |
Whether or not this tag group is visible to the public on Church Center |
multiple_options_enabled |
boolean | null |
Whether or not a group can belong to many tags within this tag group |
name |
string | null |
The name of the tag group |
position |
number | null |
The position of the tag group in relation to other tag groups |
Querying
Where
where(field, value) for equality; where(field, op, value) with the operators listed.
| Field | Value type | Operators |
|---|---|---|
name |
string |
Equality only |
Order
order(...) accepts these fields, ascending, or descending with a - prefix: name, position.
Filters
filter(...) names depend on the edge you query through:
| Edge | Filters |
|---|---|
pco.groups.tag_groups |
public |
Edges
Follow these from one TagGroup, ref = pco.groups.tag_groups.id(tagGroupId):
| Edge | Leads to | Returns | Filters | Create |
|---|---|---|---|---|
ref.tags |
Tag | Collection | No |
Writing
| Property | Value |
|---|---|
| Create | No |
| Update | No |
| Delete | No |
Example
import type { Groups } from '@mackenly/planningcenterkit';
const page = await pco.groups.tag_groups.order('name').perPage(25).list();
const items: Groups.TagGroup[] = page.data;