Overview

Groups let you segment members for operational purposes: routing them through specific matching pools, triggering targeted communications, or automatically writing attribute values when a member joins. Open the groups list from Users → Groups.

Viewing groups requires Groups page access. Creating, editing, and managing group membership requires an Edit permission on that page.

Groups list

ColumnWhat it shows
NameThe group's display name.
DescriptionOptional description.
TypeInclusive or Exclusive — see Effect on matching.
StatusActive or inactive.

Click a row to open the group's detail page. Click Add Group to create a new one.

Creating a group

On the groups list, open the actions menu and choose (add group). After you confirm the dialog, Admin shows a success message and refreshes the list. Open the new row to reach the detail page for pre-validation, attached attributes, and membership.

You can also create a group from an attribute search: on Singles Advanced Search, build filter rows and use Create Group. Admin saves those filters as the group’s pre-validation and runs sync so every matching member is attached (all pages, not just the table preview). See Create a group from filters or the reference checklist.

Add New Group dialog

Fields shown when you create a group from the list.

FieldWhat to enterNotes
Group Name Short label for ops and reports. Required — Add stays disabled until a name is entered.
Description Optional internal notes. Shown on the list and in the group header after you open the row.
Type Inclusive or Exclusive. Defaults to Inclusive. See Effect on matching. You can change type later on the detail page.

This dialog does not set profile status, pre-validation, or attached attributes — configure those on the detail page after creation.

Group fields

FieldWhat to enterNotes
Group Name A short, clear name for this group. Required.
Type Choose Inclusive or Exclusive. See Effect on matching for what this means. Required.
Description Optional notes about the group's purpose.  
Profile Status Optional. When set, a member’s profile status can move to this value when they join through a member-app path (for example a questionnaire step that attaches them to the group). Does not run when you add someone manually from Admin, from the group’s Group Users quick-add field, or when Sync Group attaches them — those paths only update membership and attached attributes.

Changes save when you click the save button in the Group Settings header.

Pre-validation

Pre-validation rules control which members qualify for member-app attachment (for example a questionnaire answer that adds someone to a group) and for Sync Group.

You can maintain multiple rule groups on one group. How they combine depends on the path:

  • Member-app attach — A member qualifies if any one rule group passes. Inside each group, filters follow that group’s AND or OR setting.
  • Sync Group — Uses only the first rule group (see Sync Group). Put the rule set you want synced at the top, or merge rules before syncing.

Rule groups with no filter rows are ignored for member-app attach (everyone is treated as eligible). Sync still requires the first group to contain at least one real filter — otherwise Admin may show a sync error instead of changing membership.

When you add a member manually from Admin, pre-validation is not checked — you can add any member regardless of the rules.

The pre-validation engine is shared with questionnaires and communications. See Pre-Validation for how to build rules.

Attached attributes

On the detail page, open the Attached attributes card (collapsed by default).

Attached attribute rules copy chosen profile answers onto a member when they first join this group. The editor uses the same answer lists as pre-validation — only attributes that have predefined answers (not free-text-only fields) appear in the picker.

ColumnWhat to chooseEffect
Attribute Name Pick an attribute from the dropdown (display labels match your brand’s attribute names). Which profile field will be updated on attach. Sensitive attributes never appear here.
Value Pick one or more answers from that attribute’s list (multi-select). Those answers replace the member’s current value for that attribute when attach runs. If you change the attribute column, Admin clears the value picks so you do not mix answers from two different attributes.

Use Add on the rules table for another row. Rows missing an attribute or at least one answer are ignored when you click Save — finish each row before saving.

When rules run:

  • First attach only — If someone is already in the group, saving the group or re-running a questionnaire step does not re-apply attached attributes. Remove and re-add membership (or edit the profile) if you need new values.
  • Manual Admin add, Group Users quick-add, Sync Group attach, and member-app paths (questionnaire post-actions) all use the same rule list.

Important: Detaching a member does not undo attribute values that were already written. Edit the member’s profile directly if you need to revert.

See Attached attributes (reference) for overwrite behaviour and inactive-group notes.

Adding and removing members

To add a member to a group manually:

  1. Open the member's profile in View End User.
  2. Scroll to the Groups section.
  3. Click Add to Group and select the group.

When you add a member manually:

  • Any attached attribute rules are applied to the member's profile immediately.
  • Pre-validation rules on the group are not checked — you can add any member.
  • The profile status field on the group does not apply — the member's status is unchanged.

To remove a member: open the same Groups section on their profile and click the remove button next to the group. Attached attributes already written are not reversed.

From the group detail page, the Group Users card lets you add someone by profile id only — there is no remove action on that table. Use the member’s profile Groups section to detach, or run Sync Group when pre-validation rules should drop members who no longer qualify.

Effect on matching

The Type field controls how the group interacts with the matching engine:

TypeMatching behaviour
Inclusive The group is used for segmentation and operational purposes (communications, reporting, attribute assignment), but does not restrict who can be matched with whom. A member in an inclusive group can still be matched with anyone.
Exclusive Members in an active exclusive group are only suggested to other members of the same exclusive group. Members who are in any exclusive group are excluded from suggestions for members who are in no exclusive group.

Most operational groups should be Inclusive unless you specifically need to create a closed matching pool.

Group detail page

Open any row on the groups list to configure one group end-to-end.

The page header shows a read-only summary (name, description, type), Group status, and actions (Save, Sync Group). Scroll the main column for editable cards:

CardWhat you configureLeft sidebar link?
Edit groupEditable fields from Group fields.Yes
Pre-ValidationRule groups for sync and member-app attach. Collapsed by default. See Pre-validation.No — scroll to this card (not listed in the sidebar today).
Attached attributesAttribute values written when someone joins. Collapsed by default. See Attached attributes.Yes
Group UsersCurrent members and quick add-by-profile-id. See Group Users table.Yes

The left sidebar lists only cards that exist on the page today (Edit group, attached attributes, and Group Users). Pre-Validation is edited on the main column but is not a sidebar jump link — scroll to that card after you open the group.

Click Save in the header after editing group fields, pre-validation, or attached attributes. Pre-validation and attached attributes do not auto-save on their own.

Sync Group

Re-run automated membership against saved pre-validation rules.

Sync Group (outlined button in the group header) re-runs the group’s saved search against your brand and reconciles membership:

  • Attaches members who now qualify and are not already in the group.
  • Detaches members who no longer qualify.

Sync uses the first pre-validation rule group on the card (including its AND/OR setting). If you maintain multiple rule groups, put the rule set you want synced in the top group, or merge rules before syncing.

The search includes internal (test) profiles as well as live members. Very large brands may stop after roughly twenty thousand matching profiles in one run — if your rule matches more than that, narrow the filters or ask engineering before relying on sync alone.

When the run finishes, Admin shows a success message with how many profiles were attached and detached. The Group Users table refreshes automatically.

PrerequisiteWhat happens if missing
At least one saved pre-validation rule group on the group Admin shows a warning and does not call sync — add a rule group, click Save, then try again.
At least one filter row in the first rule group Sync reads only that top group. An empty placeholder group (no attribute/condition rows) can trigger a sync error — add real filters to the first group before syncing.
Stored group (you opened an existing row from the list) Sync always targets that group id.

Attached attribute rules run when someone is newly attached by sync (same as manual add). Profile status on the group is not applied on sync attach. Detached members keep attribute values that were already written — attributes are never reversed on detach.

Anyone still in the group after sync either still passes the rule or was added manually and still passes. Manual adds are removed on sync only when they fail the saved search.

Group Users table

Who is in this group right now, and quick add by profile id.

Above the table, enter a Profile ID (UUID) and click Add Profile to Group to attach someone immediately. Pre-validation is not checked on this path — same as add-from-profile. Attached attributes apply on successful add.

ColumnWhat it shows
First nameMember name (links to their profile when you use the row action).
GenderStored gender attribute.
TypeUser type attribute (for example single vs parent) when configured on your brand.
CreatedWhen the profile was created.
Last SuggestionWhen this member last had an active introduction suggestion (used on the main end-users list for “no recent intro” filters). Empty if none on record.
Last LoginMost recent successful sign-in.
StatusCurrent profile status chip.
ActionsEdit icon — opens View End User for that profile.

Removing members: There is no remove button on this table. Open the member’s profile → Groups section → remove the group there. Sync may also detach members who fail pre-validation.

Status and delete

The header Group status control sets whether the group is active or inactive. Changing status saves immediately.

  • Exclusive matching — Only active exclusive groups restrict who can be suggested to whom. If you set an exclusive pool to inactive, matching stops treating it as a closed pool even if members remain listed on the group.
  • Membership — Inactive status does not automatically remove members. Admin manual add, Sync Group, and member-app attach paths can still add members today — inactive mainly turns off exclusive matching. See the full matrix on inactive groups (reference).
  • Confirm with your brand lead before deactivating a live exclusive pool.

Delete Group (requires Delete permission) permanently removes the group after confirmation. Member profiles are not deleted — only the group membership rows. Attached attribute values already written stay on each profile.