Skip to content

TagGroup (Groups)

A way to group related tags.

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;

Type to search…

↑↓ navigate↵ selectEsc close