Skip to main content

Groups

Overview​

Groups let you group users together. A group can be an company, workspace, organization, account, project, team or any other grouping that's relevant for you.

Groups are useful because they enable you to control targeting based on an entire group's behavior instead of just a single user. They also give you an overview of all users within a group.

A user can belong to many groups, which is useful if your product has workspaces, like Notion, Slack, or GitHub.

Group properties​

Group properties are just like user properties but at a group level. They're the “adjectives” that describe your groups, like name, plan, projects created, created date, etc.

With Dopt you can target users based on group properties. For example, you may want to target users to set up an integration when the group property integration_active is false.

Group properties are evaluated in start blocks to determine if a user should qualify for a flow.

info

There are no required group properties other than a unique identifier. Some properties, like name and email, are personally identifiable information (PII). As a best practice we recommend only sending properties that may be required to complete your use cases.

info

Nested group properties are currently unsupported, but will still be accepted as valid values.

Example group​

Here’s an example group with properties:

group = {
  identifier: "920c-ac33",
  properties:{
    company: "Acme Co",
    projects: 42,
    users: 139,
    plan: "Pro",
    hubspot_integration_active: false
  }
}

Identifying groups​

Groups are identified to Dopt using Dopt’s group API.

How to identify groups →