Groups — Voidhash Docs

See the companies, workspaces or teams your users belong to, who in them is active, and what they do.

Groups shows what your users belong to in your product, such as the company or workspace they use it as part of. Each kind of group is a group type, such as companies or teams, and each group has its own details, such as its name, plan or number of seats.

Groups appear once your app or website names them on its events; until then the page explains how. Your developers set this up with the SDK's group() or their server's groupIdentify; see Groups (developer docs).

Browse a group type

Open People → Groups in the sidebar.
Pick a group type from the tabs at the top. A project has up to 5.
Type in Search by name or key to find a group by its name or the key your app sends.

The list shows each group's Name, its Key, when it was First seen, and its Events, 30 days: how many events named it in the last 30 days. The groups active most recently come first. A group without a name detail shows its key as its name.

Rename a group type

Studio names a group type after the key your app sends: company reads as Companies. To call it something else, such as Customers, open the page's More menu, choose Rename followed by the type's name, and enter what one group and several groups are called. A name left blank reads from the key again. The new names show everywhere Studio counts or filters by the group type, such as in Explore. The key your app sends doesn't change.

Open a group

Select a group to see:

Details: its key, when it was first seen, and its properties as your app or server last set them. A later change of a detail replaces an earlier one.
People: who sent events with the group in the last 30 days, the most active first, with how many events and when they were last seen.
Events: the events sent most with the group over the last 30 days.

Explore opens Explore filtered to the group, to chart anything about it: how many people in it are active each week, which features they use, or how it converts.

Use groups in charts

In Explore, groups work as people do:

Count a group type instead of people, such as how many companies were active each day.
Filter by a group or by one of its details, such as only companies on the enterprise plan.
Split a chart by group or by a detail, such as events by plan.

A group's details are read as they are now, not as they were when an event happened.

When something looks wrong

A group type is missing. A project keeps the first 5 group types its events name. Events that name a sixth keep everything else, and Data health counts them under Group types over the limit; see Check your data.
A group has no name. Its details don't include name yet. Your developers set it with group() or groupIdentify.
A deleted group's events are still counted. Deleting a group removes it and its details, but its events keep its key. It comes back only when your app or server sets its details again.

Next steps