Manage Groups

Groups allow you to organize users together and to drive the information that appears to end users via web components and APIs. Groups can be used in leaderboards, as prerequisites on missions, for filtering within web components and blocks, and for segmentation of analytics.

You can manage groups using groups APIs, with data import, or in the Group Management view. The method you use will typically depend on the number of groups you need to create or the number of users you need to add to a group. When creating your initial set of groups and adding users, using an API may be faster than using Nitro Studio.

Note: If you're storing attributes that will not be used by missions, you can use preferences instead of groups.

Create a Group Class

1. Open Nitro Studio > Activity > Groups > Group Classes tab.

2. Click New.
3. Set the group class properties.

Field	Description
Name	The group class name. Names must be unique.
Is Segment	Select to define if the group class is a segment. Yes - Users can belong to only one group within the group class. No - Users can belong to multiple groups within the group class. When a group class is not a segment, that group class cannot be used as a filter in analytics or some web components or blocks.

4. Click Save or Save & add another.

Create or Edit a Group

1. Open Nitro Studio > Activity > Groups.
2. Click New. Or, to edit an existing group, click the group in the list and then click Edit ().

2. Set the group properties.

Field	Description
Name	The group name. Group names must be unique.
Short Name	The group's display name. Short names do not need to be unique.
Group Class	The group class (parent) that the group is within.
Icon URL	The group's image. This image displays in web components, when configured to show group results. Show me

3. Click Save or Save & add another.
   

Add a Group to a Group Class

1. Open Nitro Studio > Activity > Groups > Group Classes tab.
2. Click a group class to open its Detail view.
3. Click Add Group.
4. Enter the group name and select the group from the list.
5. Click Save or Save & add another.

Add Users to a Group

Although users can belong to more than one group, they can only belong to one group within the same group class if that group class is a segment.

1. Open Nitro Studio > Activity > Groups.
2. Click the group you want to add the user to.
3. Click Add User.
4. Enter the user's name and select the user from the list.
5. Enable the Transfer option if you want to move the user from another group within the same group class into this one.
6. Click Save or Save & add another.

Delete a Group

You cannot delete a group that is part of a mission. You must remove the group from the mission before deleting it.

If you delete and recreate a group, it has the same effect as resetting leaderboard data for that group. The group will have 0 points and start accruing from the time it was re-created.

1. Open Nitro Studio > Activity > Groups.
2. Hover over the group you want to delete.
3. Click Delete().
4. Confirm the deletion.

See also

Groups

Design a program

Missions