Managing readers

You can easily manage reader accounts on the Readers & groups page. It allows you to add new readers, edit or delete existing ones, and even convert reader accounts to team accounts. You can also control what content readers can access, deactivate, or activate accounts, and filter or export reader details.

Managing a Knowledge base requires seamless access control and efficient account management. Flexible user roles allow you to grant access to relevant content while protecting sensitive information. As needs evolve, you can easily upgrade readers to contributors, ensuring a smooth transition. For audits or reporting, filtering and exporting user details helps analyze activity and optimize permissions. This streamlined approach keeps your Knowledge base organized and accessible.

NOTE

You can add and manage Readers and Reader groups only if your Document360 project’s site access is set to Private or Mixed.

Overview of Readers & groups page

Navigate to Settings () > Users & security > Readers & groups > Readers in the Knowledge base portal.

Key elements of the Readers page:

1. Reader account search: Search for a reader account by name.

2. Reader account list: Displays all reader accounts for the project.

3. Status: Shows whether the account is active or inactive. An inactive status indicates the account has been deactivated.

4. Content role & access: Shows the content role and content access assigned to the account.

5. Group name: If the account belongs to a group, the group name will be displayed.

   Select the desired reader account and the following options will appear:

6. Convert to SSO account: Convert the reader account to an SSO account.

7. Convert to team account: Convert the reader account to a team account.

8. Deactivate/Activate: Deactivate or activate the reader account.

9. Delete: Delete the reader account.

   Hover over a reader account to access:

10. Email notifications (): View the email activity history for the past 30 days.

11. Edit (): Edit the configuration of the reader account

12. Delete (): Delete the reader account.

    Other features:

13. Export CSV: Export the list of reader accounts as a CSV file.

14. Filter: Use filters to narrow results by Login status, Last login date, Account types, or Status.

15. Create: Create a new reader account.

Creating a new reader account

To create a new reader account:

1. Navigate to Settings () > Users & security > Readers & groups > Readers in the Knowledge base portal.

2. Click the Create dropdown at the top right and choose New Reader to open the Create reader account panel.

3. In the Email field, enter the desired email addresses of the accounts you wish to add.

   NOTE

   You can add up to 5 emails separated by a comma at the same time.

4. Select the SSO user checkbox to add the reader as an SSO user.

5. If you selected the SSO user checkbox, select an SSO configuration from the Select SSO dropdown menu.

6. Click on the Skip invitation mail checkbox if you don't want your new readers to receive an invitation mail.

7. Select the desired Content access for the new readers.

8. In Assign groups, you can assign the readers to any existing Reader groups. This field is optional.

9. Once done, click Create reader account.

NOTE

Team accounts with Admin and Owner portal roles in a project can add and delete a reader account. Also, custom roles with Manage team accounts permission can also add reader accounts.

Importing reader accounts

You can use the Import readers feature to add more than five accounts in one go. (maximum of 500 readers)

1. Navigate to Settings () > Users & security > Readers & groups > Readers in the Knowledge base portal.

2. Click the Create dropdown at the top right and choose Import readers to open the Import reader panel.

3. Select the SSO user checkbox to add the reader as an SSO user.

4. If you selected the SSO user checkbox, select an SSO configuration from the Select SSO dropdown menu.

5. Download the CSV file template by clicking the "Download template" option.

6. Open the downloaded CSV file in a local application such as MS Excel and enter the new account emails and first and last names.

7. Save the file and upload the CSV file in the Document360 panel by clicking on Click to upload. You can also drag and drop the file into the designated drop frame.

8. The data will be validated, and the Valid emails and Invalid emails will be listed in the Validation summary table.

9. Click on Skip invitation mail if you don't want your new users to receive an invitation mail.

10. Assign the Content access and Group for the imported reader accounts using the respective dropdown.

11. Click the Import button.

Managing reader accounts

Editing a reader account

To edit the configuration of a reader account:

1. Navigate to Settings () > Users & security > Readers & groups > Readers in the Knowledge base portal.

2. Hover over the desired reader account and click the Edit () icon.

   A page will appear with detailed information.

3. Hover over the reader account name and click the Edit   icon to configure basic details such as the first name and last name.

4. You can view the Last active date and Reader account created date under the reader account name.

5. Click Manage content access to manage content access for the reader account.

6. Select the desired content access:

   1. None: Cannot access any Knowledge base content.

   2. All: Can access all Knowledge base content in any workspace and language.

   3. Workspace/Language: Can access content in specific workspaces and languages.

   4. Category: Can access certain categories in specific workspaces and languages.

7. Click Update.

8. In the Associated groups tab, add the reader account to any reader groups.

   NOTE

   Readers can only see the specific categories they are given access to and do not get automatic access to parent categories or other levels of sub-categories.

Deleting a reader account

You can delete a reader account:, following the below steps:

1. Navigate to Settings () > Users & security > Readers & groups > Readers in the Knowledge base portal.

2. Hover over the desired reader account and click the Delete () icon.

   Alternatively, select the checkbox next to one or more accounts and click Delete () at the top.

3. Click Yes in the delete confirmation panel.

Converting a reader account to a SSO account

To convert one or more reader account:

1. Navigate to Settings () > Users & security > Readers & groups > Readers in the Knowledge base portal.

2. Select the desired reader account(s) and click Convert to SSO account.

   The Account convert panel will appear.

3. Select the desired SSO Configuration.

4. Click Proceed.

   The SSO accounts can be identified with an SSO badge next to the team account name.

NOTE

When a reader account is converted to a team account, all contributions made by the reader (e.g., analytics data and feedback) will be retained.

Converting a reader account to a team account

To convert one or more reader account:

1. Navigate to Settings () > Users & security > Readers & groups > Readers in the Knowledge base portal.

2. Select the desired reader account(s) and click Convert to team account.

NOTE

If you select an SSO reader, the account will be converted to an SSO Team account.

3. Assign portal access permissions from the Portal role dropdown.

4. Assign content access permissions from the Content role and Content access dropdown.

5. As an optional step, map the reader account to any existing reader groups from the Map with existing team account group dropdown.

6. Click Confirm to convert the reader to a team account.

NOTE

When a reader account is converted to a team account, all contributions made by the reader (e.g., analytics data and feedback) will be retained.

Deactivating and reactivating a reader account

To deactivate a reader account:

1. Navigate to Settings () > Users & security > Readers & groups > Readers in the Knowledge base portal.

2. Select the desired reader account and click Deactivate at the top.

   The Confirm reader deactivation panel will appear.

3. Click Deactivate.

NOTE

When a reader account is deactivated, their analytical data and feedback are retained, but access to the Knowledge base site is revoked.

To reactivate a reader account:

1. Select one or more deactivated reader accounts.

2. Click Activate.

3. Click Confirm in the Confirm reader activation panel.

Filter and export reader account information

In the Reader & groups overview page, navigate to the top-right, where you can view Export CSV and Filter.

Filtering Reader accounts

To narrow down the list of reader accounts:

1. Click the Filter button.

2. Use the following parameters to refine your search, then click Apply:

   1. Login status: Logged readers, Never logged readers

   2. Last Login data: 7 days, 30 days, 3 months, 1 year, and Custom date.

   3. Account type: SSO user, Document360 user.

      NOTE

      Selecting SSO Users filter displays a list of available SSO configurations.

   4. Status: All, Active, Inactive.

Exporting a reader account

Click Export CSV to download the filtered list of reader accounts as a CSV file to your device's local storage.

Purchase more reader accounts

If you need more Reader accounts than your current plan offers, you can buy them as an add-on. The total number of Reader accounts available and the total number of Reader accounts used are available at the top of the page.

1. Click on the Upgrade your plan option and navigate to the pricing page.

2. Choose the desired plan, features, and number of reader accounts.

NOTE

For more information, read the article on Purchasing add-ons.

Troubleshooting

Reader import issues

Error: File upload failed

This error occurs due to issues with the file format or duplicate email addresses in the uploaded file.

Steps to resolve:

1. Ensure the reader data matches the CSV template format.

2. Verify that no email addresses are repeated in the file.

3. Remove or update any duplicates to ensure all entries are unique.

4. Save the corrected file and upload it again. This should resolve the error and successfully import the readers.

Reader unable to access a published article or category

Readers might encounter this issue when they lack the necessary permissions to access the category or article. This could be due to security settings that restrict access for the Reader or their associated Reader Group.

Steps to resolve:

1. Verify reader permissions: Ensure the reader has the correct permissions to access the category or article.

2. Check article security settings:

   1. Navigate to the article.

   2. Click the More () icon next to the Edit or Publish button.

   3. Click Security > Knowledge Base Site.

   4. Confirm that the reader is not explicitly denied access in the article’s security settings.

3. Check reader group permissions:

   1. Go to the Reader group tab within the security settings of the article.

   2. Verify that the reader group associated with the reader is not denied access to the specific article or category.

4. If the issue persists after following these steps, please contact the Document360 support team for further assistance: Contact Document360 Support

Resolving access restriction issues

Error: Sorry! You are not authorized to access.

This error occurs when the reader's access to the article is restricted due to security settings.

Steps to resolve:

1. Locate the article in the category tree.

2. Click the More () icon next to the article name.

3. Select Security > Knowledge base site.

4. Click Assign content access.

5. Remove the reader from the Reader’s list by clicking the Delete () icon.

6. Go back and confirm that the reader is now labelled with the Inherited tag.

   Now, the selected reader will be able to access the article.

   

Unable to access the associated projects

Error: Sorry! There are no projects associated with this email address. Please contact your project administrator.

This error occurs when a reader is not created as an SSO reader or has not been assigned the necessary content access in the project.

Steps to resolve:

1. Convert to an SSO reader account

1. Navigate to Settings () > Users & security > Readers & groups in the Knowledge base portal.

2. Select the desired reader and click Convert to SSO account to add them as an SSO reader.

3. Select the appropriate SSO configuration and click Proceed.

2. Assign content access

1. Hover over the desired reader and click the Edit () icon.

2. Click Manage content access and assign the required content access to the reader.

3. Click Update.

   Once the reader is assigned the correct permissions, they will be able to access the project without any issues.