KB User's Guide - Users Tab - User Access Groups

• Overview
  • Tip
• Creating a new User Access Group
• Editing an existing User Access Group
• Applying User Access Groups
  • Restricting Write access
  • Restricting Read access
  • Granting publish rights based on topics
• See Also

Overview

User Access Groups are custom groups created by KB group administrators to provide more granular control over access to documents within a Group space.

User Access Groups are most commonly used to restrict Read and/or Write access to individual documents. Members of a User Access Group can view or edit documents that are not accessible to users outside the group.

User Access Groups can also be associated with a topic, allowing members to publish documents within that topic even if they do not have general publish permissions assigned to their account.

Creating a new User Access Group

1. In the KB Admin Tools, navigate to the Users tab.

2. Click on the User Access Groups link on the left navigation bar.

3. In the Add a user access group table, enter a User Group Name and User Group Description (optional), then click the Add button.

4. Find your new User Access Group and click the Members button.

5. Select the "Member" check box for the users you would like added to the group. Once you have selected everyone who should be a member of the group, click Update.

Editing an existing User Access Group

• To change a group name:

  1. Enter a new Group name in the Group Name field.
  2. Click the Update button at the bottom of the page.

• To change a group's description:

  1. Enter the new description in the Group Description field.
  2. Click the Update button at the bottom of the page.

• To add or remove members:

  1. Click the Members button for the appropriate Group.
  2. Check or uncheck a box to add or remove a member.
  3. Click the Update button to save changes.
  4. If refreshing, you may click Select All or Deselect All to make it easier to clear the list.

• To deactivate or activate a group:

  1. Toggle the Active checkbox as checked or unchecked depending on whether you are activating the group (checked) or deactivating the group (unchecked).
  2. Click the Update button at the bottom of the page.

• To delete a group:

  1. Click the Delete button to the right of the group. 
  2. Confirm your choice in the dialog window. Please note that deleting the group will remove any document restrictions the group had previously been controlling.

Applying User Access Groups

User Access Groups can be associated with documents to restrict write and read access, or to topics to grant conditional publish rights.

Restricting Write access

Your active User Access Groups appear in the Write access section of the document edit screen, typically collapsed under the Show all write access toggle. Selecting one or more groups limits who can edit the document, though the exact set of authorized editors also depends on the standard write‑access option chosen for the document.

If Owner or Owner group admins is selected, checking a User Access Group adds those members as additional editors. If Owner group is selected, checking a User Access Group narrows editing permissions to only the members of that group (along with the owner, who always retains write access).

Example: Both Owner group admins and the members of the KB Team User Access Groups have permission to edit the document. This means all group admins, as well as all members of the KB Team, are authorized editors.

Restricting Read access

Your active User Access Groups appear in the Read access section of the document edit screen, typically collapsed under the Show all read access toggle. Selecting one or more groups limits who can view the document in both the KB Admin Tools and your internal site. The document owner always retains read access.

Authors who do not have read access will see different behavior depending on whether they have publish rights in your group space:

• Authors without publish rights — They cannot view the document or access its edit screen. The document title will not appear as a link, and the Edit button will appear disabled. Attempts to access the document or its edit screen directly will result in an error message.

• Authors with publish rights — They can open the edit screen, but all text fields will be grayed out and replaced with a notice indicating they do not have read access. They can still modify most settings below the document, such as topics and site access. However, they cannot change the read‑access setting and therefore cannot grant themselves access.

Note: Additional groups may appear in this section if they are populated through Group Authorization rules. Hovering over a group displays a tooltip showing either the list of members (for User Access Groups) or the rule criteria (for authorization‑based groups).

Granting publish rights based on topics

You can associate a User Access Group with a topic in your topics tree with the Admin group topic setting. For more information about topics, please see KB User's Guide - Topics Tab - Adding, Editing, and Deleting Topics.

When any member of the selected User Access Group edits a document with that topic assigned to it, they will have the ability to publish the document, even if their user account does not have the "Publish" permission checked.

This is useful for cases where you want to allow an author to publish documents that are specifically related to their area of expertise.