Navigation, Roles and Permissions

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

  1. Locate the module row and the role column.
  2. Open the arrow beside the permission label to view Advanced permissions.
  3. Select the permission to enable or remove it. Required dependent permissions adjust automatically.
  4. 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.

  1. Open the bulk update controls.
  2. Select a Role. Global Admin is excluded from this selector.
  3. Select Read, Write, Delete, Navigate or All.
  4. Select Apply selected permission to all modules or Remove selected permission from all modules.
  5. 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.

Configure navigation

Open Navigation to configure menu presentation. This area requires the Custom Navigation feature. If you see Feature Not Enabled, contact your account manager or support@privork.com.

The page contains a layout preview and a module/feature tree. Select an item in the preview or tree to inspect it. Expand parent rows to find child features. The preview helps you review the arrangement; verify the final result in the application after saving and reloading.

Active
Controls whether the item is enabled for navigation. Users still need the relevant Navigate permission. An inactive parent can also prevent its children from appearing.
Descriptors
Controls whether the item is shown in descriptors. This setting is separate from menu activation and security permissions.
Placement
Choose the available locations: sidebar for the side menu, top for top navigation, or internal for navigation within the relevant module. Where allowed, an item can have more than one placement.
Icon
Open the icon picker, search for an icon and select it. Select Default to use the module’s default icon.
State
Staged means the row has pending changes. Saved means it has no pending grid changes.

Some items have fixed placement. Search, Pin and Administration remain in the top bar. Placement controls are unavailable for Tags and for items whose position is fixed. Clearing every placement falls back to the item’s default placement; use Active to hide an item from the menu.

Edit a module’s display details

Hover over a module row and select Edit module. You can change its name, description, Active setting, Descriptors setting, icon and available placements. The Parent field is read-only. Select Update to save that module, or Cancel to close the dialog without applying its edits.

Update saves the edited module directly. Other staged grid changes still need to be saved separately. Adding or deleting custom modules is unavailable in this release.

Save and reset navigation settings

Save changes made in the grid

  1. Review rows marked Staged and the layout preview.
  2. Select Save beside Navigation. The badge shows the number of changed items.
  3. Confirm the save and wait for the success message.
  4. 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

  1. Select All Default.
  2. Confirm Reset All Navigation Defaults. This stages default navigation settings for every module and feature.
  3. Review the staged results, select Save and confirm.
  4. 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.

October 27, 2026