Cargo-Planner Docs

Roles and permissions

Each user in Cargo-Planner is assigned a single role that determines their level of access. Roles are hierarchical — each role includes all the permissions of the roles below it.

Roles

The roles from lowest to highest level of access:

  1. Planner (default) - Can create, view, edit and delete load lists. This is the base role assigned to all new users.
  2. Editor - Everything the Planner can do, plus the ability to create and modify equipment, cargo libraries, presets and projects.
  3. Developer - Everything the Editor can do, plus access to API tokens and webhook management for integrations.
  4. Administrator - Everything the Developer can do, plus user management, company details and subscription management.

Feature permissions

Users with the Planner role can optionally be granted individual feature permissions. This allows you to give a Planner access to specific editing capabilities without promoting them to a full Editor role. The available feature permissions are:

PermissionAllows
Cargo EditorCreate and modify cargo library items
Equipment EditorCreate and modify equipment
Project EditorCreate and modify projects
Preset EditorCreate and modify load presets
Company EditorModify company details

Feature permissions are only relevant for the Planner role. Users with the Editor role or above already have all these capabilities as part of their role.

Additional properties

Isolated

Isolated is a property that can be enabled on any user regardless of their role. An isolated user:

  • Can only see load lists they have created themselves
  • Cannot see load lists or projects created by other users in the organization
  • Has their load lists automatically placed in a project named after their username

Other non-isolated users in the organization can see load lists created by isolated users. This makes isolated mode useful for external users (e.g., customers or partners) who should be able to plan their own shipments, while internal staff can still view and manage those plans.

An isolated user cannot be an Administrator.

Permission matrix

The tables below show what each role can do:

Loadlist operations

TaskPlannerEditorDeveloperAdministrator
ViewYesYesYesYes
CreateYesYesYesYes
EditYesYesYesYes
DeleteYesYesYesYes

Project operations

TaskPlannerEditorDeveloperAdministrator
ViewYesYesYesYes
CreateNoYesYesYes
EditNoYesYesYes
DeleteNoYesYesYes

Equipment library operations

TaskPlannerEditorDeveloperAdministrator
ViewYesYesYesYes
CreateNoYesYesYes
EditNoYesYesYes
DeleteNoYesYesYes

Cargo library operations

TaskPlannerEditorDeveloperAdministrator
ViewYesYesYesYes
CreateNoYesYesYes
EditNoYesYesYes
DeleteNoYesYesYes

API Token management

TaskPlannerEditorDeveloperAdministrator
ViewNoNoYesYes
CreateNoNoYesYes
EditNoNoYesYes
DeleteNoNoYesYes

Webhooks management

TaskPlannerEditorDeveloperAdministrator
ViewNoNoYesYes
CreateNoNoYesYes
EditNoNoYesYes
DeleteNoNoYesYes

User management

TaskPlannerEditorDeveloperAdministrator
ViewNoNoNoYes
CreateNoNoNoYes
EditNoNoNoYes
DeleteNoNoNoYes

Subscription management

TaskPlannerEditorDeveloperAdministrator
ViewNoNoNoYes
ManageNoNoNoYes