Handbook X Coordinator WebUI Manual

6. Workgroup

A workgroup is a feature for managing users and content at the organization or team level. By creating a workgroup and inviting members, you can share books within the team.

Note: Workgroup management features (creation, settings changes, member invitations, etc.) are only available to users with plans that include workgroup features (Enterprise, Business, Team) or users with administrator privileges (Owner/Admin).

6.1 Workgroup List

Opening the Workgroup tab displays a list of workgroups.

Display Modes

You can switch between displays using the tabs at the top of the screen.

6.2 Owned and Joined Workgroups

Owned Workgroup

Workgroups you have created. The following operations are available:

Owned Workgroups

Joined Workgroup

Workgroups you have joined via invitation. Available operations vary by sharing privilege.

Sharing Privilege Description Available Operations
Manage sharing privilege Can share books to the workgroup Invite members, change sharing privileges, share books, etc.
With sharing privilege Can share books to the workgroup Share books
No sharing privilege Can view shared books View shared books

Joined Workgroups

6.3 Creating a Workgroup

To create a new workgroup:

  1. Select the Owned tab and click the Add button
  2. The Add Workgroup dialog appears

Add Workgroup Dialog

  1. Enter the following information:
Item Required Description
Workgroup Name Name of the workgroup
Allow Participate - ON: Participate mode (join requests via QR code or search allowed), OFF: Invite mode (invitation only) *Cloud version only
Auto Approve - Automatically approve join requests (Only displayed when "Allow Participate" is ON) *Cloud version only
  1. Click the Create button

Allow Participate Setting

Workgroup Creation Limits

The number of workgroups you can create varies by plan.

Plan Max Workgroups
Free 1
Personal 1
Team 5
Business Unlimited
Enterprise Unlimited

Note: Once you reach the limit, you cannot create new workgroups. If you see the message "too many workgroups", please consider upgrading your plan.

Workgroup Member Limits

The number of members you can invite to each workgroup also varies by plan.

Plan Max Members
Free 3
Personal 5
Team 6+ (can be increased with plan)
Business 50+ (can be increased with plan)
Enterprise Configured per plan

Note: The member count does not include the workgroup owner.

6.4 Joining a Workgroup

Joining via Invitation (Cloud Version)

  1. Receive an invitation email
  2. Click the link in the email
  3. Log in to join the workgroup

Join Request (Cloud Version)

You can send join requests to public workgroups.

  1. Select the Joined tab and click the Join button
  2. The Join Workgroup dialog appears
  3. Enter the workgroup ID or name you want to join
  4. Click the Join button
  5. You can join once the workgroup owner or admin approves

Checking Invitation Notifications (Cloud Version)

  1. Select the Joined tab and click the Notification button
  2. The Invitation Notification dialog appears
  3. Accept or Reject the invitation

6.5 Workgroup Settings

To change workgroup settings:

  1. Click the Settings button (Settings) in the workgroup list
  2. The Workgroup Settings dialog appears

Workgroup Settings Dialog

  1. Modify the settings
  2. Click the Save button

Configurable Settings (Cloud version only)

Item Description
Allow Participate ON: Participate mode (join requests via QR code or search allowed), OFF: Invite mode (invitation only)
Auto Approve Automatically approve join requests (Only displayed when "Allow Participate" is ON)

6.6 Member Management

For details on member management, see 6.6 Member Management.

6.7 Importing and Exporting Users

Importing Users

You can bulk import 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.

Cloud Version CSV Format (7 columns)
Mailaddress,Firstname,Lastname,Role,State,OrganizationGroup,Password
user1@example.com,Taro,Yamada,editor,accepted,,
user2@example.com,Hanako,Suzuki,reader,accepted,,
user3@example.com,Ichiro,Sato,admin,accepted,,
Column Name Required Description
Mailaddress User's email address
Firstname - User's first name
Lastname - User's last name
Role - Sharing privilege: admin/editor/reader (default: reader)
admin=Manage sharing privilege, editor=With sharing privilege, reader=No sharing privilege
State - User's state: accepted (invitation accepted) / invited (pending), etc.
OrganizationGroup - Organization group (usually empty)
Password - Ignored in cloud version (column required for compatibility)

Import Download sample CSV file

Dedicated Server CSV Format (4 columns)

For dedicated server version, a simplified 4-column format is used.

Mailaddress,Role,OrganizationGroup,Password
user1@example.com,editor,,Password123
user2@example.com,reader,,Password456
user3@example.com,admin,,Password789
Column Name Required Description
Mailaddress Username (does not need to be email format)
Role - Sharing privilege: admin/editor/reader (default: reader)
OrganizationGroup - Organization group (usually empty)
Password - Initial password

Import Download sample CSV file for Dedicated Server

Password Requirements: - Length: 8-32 characters - Allowed characters: Any characters including letters (uppercase/lowercase), numbers, and symbols

Differences between Cloud and Dedicated Server versions: - Cloud version: 7-column format, Firstname/Lastname/State are used, Password is ignored, Mailaddress must be in email format - Dedicated Server: 4-column format, Password can be set as initial password, Mailaddress can be any username (not required to be email format)

Notes for creating CSV files: - Each data row must have the same number of columns (comma-separated) as the header row - Do not include empty lines at the end of the file (this will cause errors) - Even for empty columns, do not omit the commas - For cloud version, it is recommended to specify accepted for the State field

Exporting Users (Cloud Version)

You can export workgroup member information as a CSV file.

  1. Click the Export button (Export)
  2. A CSV file is downloaded

The exported CSV uses the same format as import (Mailaddress,Firstname,Lastname,Role,State,OrganizationGroup,Password).

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

6.8 QR Code Invitation

Note: This feature is only available in the cloud version.

You can easily invite users using a QR code.

  1. Click the QR Code button
  2. The QR Code dialog appears
  3. Print or save the QR code as an image

Users can scan the QR code in the app to send a join request.

6.9 Device ID Restrictions (Dedicated Server Only)

A feature that allows access only from specific device IDs. Administrators can approve or deny device IDs that users have logged in from, allowing only permitted devices to access the workgroup.

Note: Device ID restriction is only available in the dedicated server version with specific plans (plans with the devid feature enabled). It is not available in the cloud version.

Difference Between "Device ID Restrictions" and "Platform Restrictions"

Handbook X Coordinator has two types of device restriction features. It's important to understand the differences as they can be easily confused.

Item Device ID Restrictions (This Section) Platform Restrictions (See 7.7)
Restriction Unit Per individual device Per platform (OS type)
Setting Location Workgroup > Device Restrictions Accounts > Device Restrictions
Scope Per workgroup Per account (user)
Restriction Method Approve/deny logged-in device IDs Allow/prohibit iOS/Android/Windows/Browser
Availability Dedicated server (with devid feature) Dedicated server
Use Case Allow only specific company-issued devices "Prohibit access from smartphones", etc.

Example: Device ID Restrictions - Yamada's "iPhone A" → Allowed - Yamada's "iPhone B" → Denied (personal device) - Suzuki's "iPad C" → Allowed

Example: Platform Restrictions - Yamada → iOS prohibited (no access from any iPhone/iPad) - Suzuki → Browser prohibited (no access from PC browsers)

Tip: For platform restrictions, see 7.7 Device Restrictions Settings.

Enabling Device ID Restrictions

  1. Click workgroup settings (Settings)
  2. Turn on "Use access restriction by device ID"
  3. Click the Save button

When this setting is enabled, an "Allowed Device IDs" column will appear in the workgroup member list.

Managing Device IDs

  1. Click the Device Restrictions button
  2. The "Device Usage Restrictions" dialog appears
  3. A list of devices that each user has logged in from is displayed:
  4. Account Name
  5. Devices (Device ID and access permission status)
  6. Click a device to toggle between enabled/disabled
  7. You can perform bulk operations on multiple devices:
  8. Enable selected devices: Enable all devices for selected users
  9. Disable selected devices: Disable all devices for selected users
  10. Enable All for the workgroup: Enable all devices for all users
  11. Disable All for the workgroup: Disable all devices for all users

Device ID Registration Flow

  1. A user logs in to the workgroup from the app
  2. The device ID is automatically recorded at login
  3. Administrator reviews the device IDs in the device restrictions screen
  4. Administrator allows or denies each device ID
  5. Only allowed device IDs can access the workgroup

Note: In workgroups with device ID restrictions enabled, access from devices not approved by the administrator is not possible. If logging in from a new device, please request approval from the administrator.

6.10 Leaving a Workgroup

To leave a workgroup you have joined:

  1. Select the Joined tab and select the workgroup you want to leave
  2. Click the Quit button on your row in the member list
  3. Click Quit in the confirmation dialog

Note: After leaving, you will no longer be able to access books in that workgroup.

6.11 Deleting a Workgroup

To delete a workgroup you own:

  1. Select the Owned tab and select the workgroup you want to delete
  2. Click the Delete button (Delete)
  3. The confirmation dialog appears

Delete Workgroup Dialog

  1. Enter the workgroup name and click Delete

Note: Deleting a workgroup also deletes: - All books in the workgroup - All sharing settings - All groups

This action cannot be undone.


← Previous: 5. Groups | Next: 6.6 Member Management →