Handbook X Coordinator WebUI Manual

5. Groups

The Groups feature allows you to organize users into groups for efficient management. By sharing books at the group level, you can automatically handle user additions and removals.

Note: The Add button visibility depends on your environment: - Cloud Service: Displayed if you have joined a workgroup - Dedicated Server (On-premises): Displayed only for users with workgroup administrator privileges (Owner/Admin)

5.1 Group List

Opening the Groups tab displays a list of groups.

Group List

Display Items

Item Description
Group Name Name of the group
Users Users belonging to the group
Referenced groups Parent groups that reference this group
Reference Group Child groups that this group references

Viewing Group Users

The Users column displays icons and names of belonging users. If there are many users, click the "..." icon to view all users.

5.2 Selecting a Workgroup

You can switch the displayed workgroup from the dropdown at the top of the group list.

  1. Click on the Workgroup name
  2. A dropdown menu appears
  3. Select the workgroup you want to display

Note: Groups are managed per workgroup. Switching workgroups displays the groups of that workgroup.

5.3 Creating a Group

To create a new group:

  1. Click the Add button
  2. The "Add Group" dialog appears

Add Group Dialog

  1. Enter the following information:
Item Required Description
Group Name Name of the group (max 100 characters)
Users - Users to add to the group
Referenced groups - Set parent groups that reference this group
Reference Group - Set child groups that this group references
  1. Click the Save button

Selecting Users

  1. Select users' checkboxes in the Users section
  2. The "Selected" count shows the number of selected users
  3. You can search for users using the search box

5.4 Editing a Group

To edit an existing group:

  1. Click the Edit button (Edit) of the group you want to edit in the group list
  2. The "Edit Group" dialog appears

Edit Group Dialog

  1. Modify the information:
  2. Group Name
  3. Add/remove users
  4. Change Referenced groups/Reference Group
  5. Click the Save button

5.5 Removing a Group

To remove a group:

  1. Click the Remove button (Delete) of the group you want to remove in the group list
  2. The "Remove Group" confirmation dialog appears
  3. Click the Remove button

Note: Removing a group does not delete the users who belonged to the group.

Note: Removing a group also removes sharing settings for that group.

5.6 Managing Group Users

Adding Users

  1. Open the Edit Group dialog
  2. Select users' checkboxes in the Users section
  3. Click the Save button

Removing Users

  1. Open the Edit Group dialog
  2. Uncheck the checkbox of the user you want to remove in the Users section
  3. Click the Save button

Viewing All Users

  1. Click the "..." icon in the group list
  2. The group users list dialog appears
  3. You can view all users

5.7 Referenced Groups and Reference Groups

Groups can have a hierarchical structure.

Referenced Groups (Parent Groups)

Reference Groups (Child Groups)

Setting Hierarchy

  1. Open the Edit Group dialog
  2. Select groups' checkboxes in the Referenced groups or Reference Group section
  3. Click the Save button

Tip: You can represent organizational structures like Department > Team > Project using groups.

Group Limitations

Item Limit
Users per group No limit
Referenced groups (parent groups) per group Maximum 100
Reference groups (child groups) per group Maximum 100

5.8 Importing Groups

You can bulk import groups and users from a CSV file.

  1. Click the Import button (Import)
  2. The Import dialog appears
  3. Select a CSV file
  4. Preview the content
  5. Click the Import button

CSV File Format

Important: The CSV header (column names) must use the exact English labels shown below. Other label names are not supported.

GroupID,Groupname,UserMember,OrganizationGroupMember
,Sales,user1@example.com,
,Sales,user2@example.com,
,Development,user3@example.com,
Column Name Required Description
GroupID - Group ID (leave empty for new groups)
Groupname Name of the group
UserMember User's email address
OrganizationGroupMember - Organization group member (usually empty)

Import Download sample CSV file

Note: Users to be imported must already be members of the workgroup.

5.9 Exporting Groups

You can export group and user information as a CSV file.

  1. Click the Export button (Export)
  2. The Export dialog appears
  3. Select groups to export (all or selected)
  4. Click the Export button
  5. A CSV file is downloaded

Exported CSV Format

The exported CSV uses the same format as import, containing the following columns:

GroupID,Groupname,UserMember,OrganizationGroupMember
642bcbd2-56a8-4b6e-817b-2b9069394f56,Sales,user1@example.com,
642bcbd2-56a8-4b6e-817b-2b9069394f56,Sales,user2@example.com,
Column Name Description
GroupID Unique identifier for the group (UUID)
Groupname Name of the group
UserMember User's email address
OrganizationGroupMember Organization group member

Tip: You can edit the exported CSV file and re-import it to perform bulk updates.


← Previous: 4. Share | Next: 6. Workgroup →