Understanding Groups
Groups are the primary way to organize entities in StructureGram. Think of them as containers that help you separate different clients, families, or projects.
What is a Group?
A Group is a collection of entities (individuals, companies, trusts, partnerships, SMSFs, and assets) that belong together. Each entity can belong to:
- Multiple Groups - entities can appear in more than one group
- Ungrouped - entities can remain without any group assignment
- Multiple Entity Filters - focused subsets within each group
Common Use Cases
For Professional Advisors:
- One group per client family
- One group per corporate structure
- One group per estate planning engagement
For Corporate Users:
- One group per business division
- One group per project
- One group per legal entity hierarchy
How Groups Work
Entity Assignment
When you create an entity, you can assign it to a group:
- During Creation: Select a group from the dropdown when creating an entity
- After Creation: Change the group assignment in the entity's edit dialog
- Ungrouped: Leave entities without a group assignment (accessible from "All Entities" view)
Group Scope
All entities in a group:
- Are accessible when viewing that group
- Can be included in diagrams for that group
- Can be filtered into entity filters for focused views
When you create a saved diagram for a group, StructureGram creates that diagram's entity filter from the group entities available at that time. If you add more entities to the group later, add them to any existing diagrams where they should appear.
If a diagram needs to show entities from other groups that are directly related to its filter entities, turn on the Include external entities checkbox in the Entities dialog. This pulls in directly related entities from other groups for context without expanding the diagram's filter. See Include External Entities under Working with Entity Filters.
Switching Between Groups
Use the group selector in the top navigation to switch between:
- All Entities: View all entities across all groups
- Individual Groups: View entities and diagrams for a specific group
The selected group is your active group for that organisation. It provides the default context for group-scoped lists, diagrams, and new work.
Groups Across Browser Tabs
Your active group is shared for your account within the active organisation. It is not an independent setting for each browser tab. When you select another group, other open tabs may update immediately or use the new group the next time they refresh or navigate.
You can open saved diagrams from different groups in separate tabs because each diagram belongs to a specific group. However, pages and actions that use the active group, including group-filtered lists and some creation flows, follow the current shared selection. Check the organisation and group selectors before creating or changing data.
StructureGram supports organising many clients, families, and projects as groups within one organisation. Use a separate organisation only when you need a completely separate membership, administration, billing, or data boundary.
Groups vs. Entity Filters
Understanding the difference between Groups and Entity Filters is important:
| Concept | Purpose | Scope | Assignment |
|---|---|---|---|
| Group | Primary organization by client/family | All entities for that client | Multiple groups per entity |
| Entities | Focused view for specific diagrams | Selected subset of group entities | Multiple entity filters per entity |
Example:
- Group: "Smith Family Trust Structure" (30 entities)
- Entity Filter 1: "Operating Companies Only" (8 entities)
- Entity Filter 2: "Trust and Beneficiaries" (12 entities)
- Entity Filter 3: "Asset Holdings" (15 entities)
Groups Inside Groups
A group can sit inside another group, one level deep. Use this when one client has several parts you want to keep apart but also see together, such as a family group holding a group for each branch of the family.
- A parent shows its children's entities. The parent's lists, diagrams and entity counts include the entities filed in the groups inside it, as well as its own.
- A parent's access applies in its children. Anyone granted access to the parent has the same access in every group inside it. See Group Access and Permissions.
- One level only. A group that is inside another can't hold groups of its own, and a group that holds groups can't be placed inside another.
- Restricted groups can't be nested. A restricted group can't hold other groups or sit inside one.
- XPM and FYI work on a group's own entities. Pushing, pulling and reconciling with XPM, and FYI's client suggestions, use only the entities filed directly in that group, not those in the groups inside it.
On the Groups page, a group inside another is drawn under its parent. A child shows an In badge naming its parent (for example In Smith Family), and a parent shows a Holds badge (for example Holds 2 groups). Hover over a badge to see the group names.
Placing a group inside another
Choose the parent in the Inside group field when you create or edit a group. It starts at None (a top-level group). The list offers only open, top-level groups that you manage access for, and you can search it.
When you pick a parent, the dialog tells you what changes, for example "2 grants on “Smith Family” will apply in this group too". To move a group into, out of, or between parents, you need to manage access for the group and for each parent it leaves or joins.
Taking a group out of its parent
Set Inside group back to None (a top-level group), or choose a different parent. The old parent's grants stop applying in the group straight away, and the group's entities leave the old parent's filter groups and the diagrams based on them. The dialog says how many entity placements leave the parent's diagrams before you save.
Creating and Managing Groups
Groups are managed on the Groups page in the left-hand navigation.
Creating a Group
- Go to Groups
- Click Create Group
- Enter a Group Name (e.g., "Smith Family Structure")
- Optionally add a Description
- Optionally choose a parent in Inside group
- Click Create Group
See How to Create a Group for the full steps.
Renaming a Group
- Go to Groups
- Find the group and click the pencil icon (Edit group details)
- Update the name, description or Inside group
- Click Save Changes
Deleting a Group
- Go to Groups
- Find the group, open its More actions menu (⋯) and choose Delete
- If the group is linked to XPM, choose where to delete it: StructureGram only (XPM is unchanged) or StructureGram and XPM
- Choose what happens to the group's entities:
- Keep member records: only the group is deleted; its entities stay.
- Delete member records: the entities filed in this group are deleted too. An entity that is also in another group is kept. With StructureGram and XPM, an XPM client that is still in another XPM group is kept in XPM.
- If you chose StructureGram and XPM, type the group name to confirm
- Check the Summary of changes and click Delete selected items
Warning: Deleting a group can't be undone. Its diagrams and entity filters are deleted with it.
If the group holds other groups, they become top-level groups and keep their entities, diagrams and filter groups; deleting a parent never deletes a child's entities. If the group is inside a parent, the summary says how many entity placements leave the parent's diagrams.
Best Practices
Group Naming
Good Names:
- "Smith Family Trust Structure"
- "ABC Corp Subsidiary Holdings"
- "Estate Planning - Johnson Family"
Avoid:
- Generic names like "Client 1", "Test", "Misc"
- Names without context
- Duplicate names (adds confusion)
Group Organization
Do:
- Create separate groups for unrelated clients/families
- Use descriptive names and descriptions
- Keep group membership current
- Keep related groups in one organisation when they share administration and data governance
Don't:
- Mix unrelated clients in one group
- Leave important entities ungrouped without purpose
When to Create a New Group
Create a new group when you're working with:
- A new client engagement
- A completely separate family structure
- An independent corporate structure
- A distinct project with its own entities
When to Use Entity Filters Instead
Use entity filters (not new groups) when you want to:
- Show only operating entities within a group
- Focus on trust structures only
- Create client presentation views
- Filter entities for specific analysis
Related Topics
- Working with Entity Filters
- Groups vs. Entity Filters: Quick Reference
- Group Access and Permissions
- Access, Teams, and Sharing Overview
- Guest Sharing
- Creating Entities
- Managing Diagrams
- Organization Settings
- How to Create a Group
- Xero Practice Manager Sync — sync XPM groups into StructureGram
- Push to Xero Practice Manager — push group data to XPM
- XPM Reconciliation — compare group data between SG and XPM