ADMINISTRATOR GUIDE
Administration, Security and Navigation
Use administration to manage who can use the product, what each role can do, and where modules and features appear in the application. This guide explains how user roles, module permissions and navigation settings work together.
Find administration and open help
Open Administration from the application’s top bar. The options available to you depend on your access. Open the module security page to use its Security and Navigation tabs. The page heading changes to Module Security or Navigation Management as you switch tabs.
Click the question-mark help button at the upper right of the page to open the relevant help article in a popup. On the module security and navigation screen, both tabs use this guide. You can follow the article link at the bottom of the popup to open it in a separate browser tab, or select Close help to return to your work.
Other administration areas, such as user management and organization settings, have their own help articles. Your account may not have access to every administration area.
Understand users, roles and permissions
Access is managed in three connected places:
- User management: assign or remove roles for an individual user.
- Security: define the module permissions available to each role. A change here affects users who hold that role.
- Navigation: configure whether a menu item is active, its placement and its icon. These are shared navigation settings rather than a personal menu layout.
To change a user’s roles, open User Management, select the user and open their Security tab. Use the Activate control for the required role and wait for the saved confirmation. Some roles are restricted or reserved for support.
Menu visibility and permission to perform an action are separate controls. Making a menu item active does not assign a role or grant editing rights. Hiding an item from navigation does not remove its security permissions. Review both tabs when changing access.
Manage module security
The Security tab displays a matrix. Rows represent modules and features, and columns represent roles. Expand a parent row to see its child features. If a role column is hidden, use the grid’s column controls to show it. The Global Admin column is hidden by default and its permission controls cannot be edited here.
Permission types
- Read
- Allows viewing information where the module supports it.
- Write
- Allows creating or updating information where supported. Enabling Write also enables Read.
- Delete
- Allows deleting information where supported. Enabling Delete also enables Write and Read.
- Navigate
- Allows the module to be included in navigation for the role, subject to menu configuration and parent visibility. Enabling Navigate also enables Read.
Dependencies also apply when removing permissions: removing Read removes Write, Delete and Navigate; removing Write removes Delete. Removing Delete does not automatically remove Write or Read, and removing Navigate does not automatically remove Read.
Change a role’s permissions for a module
- Locate the module row and the role column.
- Open the arrow beside the permission label to view Advanced permissions.
- Select the permission to enable or remove it. Required dependent permissions adjust automatically.
- Wait for the update confirmation, then review the resulting permissions.
The main permission button is a shortcut: it applies all permissions when the cell is not fully enabled, or removes all permissions when all are already enabled. The dropdown also provides Apply all or Remove all. Actions on a parent module can update its child features too, so review the expanded rows afterward.
Read the permission labels
Labels summarize the current combination: NONE, READ, WRITE, DELETE, NAVIGATE, FULL or CUSTOM. Open Advanced permissions to check the individual permissions rather than relying only on the summary. NAVIGATE includes Read; FULL includes Delete and Navigate with their required dependencies.
Apply bulk permission changes
Use Bulk update beside Security when the same change should apply across every module for one role.
- Open the bulk update controls.
- Select a Role. Global Admin is excluded from this selector.
- Select Read, Write, Delete, Navigate or All.
- Select Apply selected permission to all modules or Remove selected permission from all modules.
- Wait for completion and review the matrix.
Bulk actions save immediately and affect every module for the selected role, including modules outside the currently visible rows. Permission dependencies still apply. For example, applying Write also enables Read, while removing Read also removes dependent permissions.
Save and reset navigation settings
Save changes made in the grid
- Review rows marked Staged and the layout preview.
- Select Save beside Navigation. The badge shows the number of changed items.
- Confirm the save and wait for the success message.
- Reload the application so the navigation menu reflects the saved settings.
Save appears when there are pending grid changes. Save them before leaving or reloading the page.
Restore default navigation
- Select All Default.
- Confirm Reset All Navigation Defaults. This stages default navigation settings for every module and feature.
- Review the staged results, select Save and confirm.
- Reload the application.
This reset restores navigation display defaults, including icons and placement. It does not reset module security, user role assignments, module names, descriptions, Active checkboxes or Descriptors checkboxes.
Troubleshoot common problems
A user cannot see a module
Check the user’s assigned roles, the role’s Navigate permission, the item’s Active setting and its placement. Check the parent module as well. Save any staged navigation changes and reload the application.
A user can view a module but cannot edit or delete information
Review Write and Delete for the user’s role on the relevant module or child feature. Read or Navigate alone does not grant those actions.
A permission changed when I selected another permission
This can result from permission dependencies. Write requires Read; Delete requires Write and Read; Navigate requires Read. Parent-level changes can also update child features.
My navigation changes are not visible
Check for Staged rows, save pending changes and reload the app. If you edited one module with Update, check whether other rows still need Save. Confirm that the affected user has Navigate access.
A save or bulk update failed
Read the error message and reload to check what was actually saved before retrying. A multi-module operation may have saved some changes before an error occurred.
I lost access after changing security
Ask another authorized administrator to review your role assignments and module permissions. If no authorized administrator can restore access, contact support@privork.com.