ClickHelp Documentation

Power Reader Roles


Once you create a Power Reader in your portal, you can control which publications are available to this user. There are two ways to define Power Reader permissions - on the User level, and on the Role level. Roles help you define and control access permissions in a centralized manner for multiple Power Readers.

Power Reader Without a Role

By default, no Role is assigned to a Power Reader. In this case, this Power Reader's properties indicate that there is no role assigned as can be seen in the Power Reader's profile (to open a Power Reader's profile, go to Tools > Users and Roles > Power Readers and click the name of the desired Power Reader on the list):

This means that you define all access permissions on the user level, and they apply to this specific user only. This approach is good enough when different Power Readers have absolutely different access permissions, and you want to give or deny access on the per-user basis.

Power Reader With a Role

Sometimes multiple Power Readers should have the same access level. This happens when there are user groups inside your readers audience, and you want to control access on a group level instead of the user level. A good example may be Database Administrators and Server Administrators - both groups require logging in to read the docs, but they need to see different sets of docs in your portal.

To accomplish this access management task easier, use Power Reader Roles. The idea is simple - you define a Power Reader Role and set access permissions for this role. To create a new role, do the following:

  • In the main menu, click Tools | Users and Roles
  • On the user management page that opens, select Power Reader Roles in the left-hand navigation bar.
  • Now click the big Create Power Reader Role button:

  • After clicking the button, specify the new role name in the right-side role editor, and specify which Restricted Publications are available to this Power Reader Role:

  • The click Save Role.

Later on, when you need to change permissions for a group of Power Readers that have a specific role assigned, you change them in the role properties like we did earlier when setting up the role for the first time. As a result, all Power Readers who have this role assigned will have their access permissions changed.

User and Role Permissions Merge

In fact, you can define permissions on two levels simultaneously - user level and role level.

For example, all users with the "Designer" role have access to "guide-publication" only:

However, you can also grant individual access to other publications to the user without giving this access to other users with the same role. This is simple - you just choose a Power Reader and click Edit user's profile button:

 As you see the role "Designer" is assigned to Beatrice and to another user. According to this role they have access to "guide-publication": 

But you can give individual permission to her, just choose necessary publication and click Save Changes:

Another user with the same role will not have access to this publication, only Beatrice will have.

Information The Power Reader access permissions add up - role-level permissions and user-level permissions merge.    

Please note that changing the permissions on the user level does not change permissions for other users that have the same role. User-level changes apply only to that specific user, and the Role permissions merge with the User permissions.