Departments (Developer)
The developer Departments screen lists every department across the whole system, regardless of which company they belong to. From here you can search and filter departments, open a department's full details, add a new department (assigned to a specific company or made global), edit a department, and delete one.
A department can be either:
- Company — tied to a single company.
- Global — not tied to any company, so it is available system-wide.
⚠️ Developer Access Only
This screen is part of the Developer portal. The Add, Edit, and Delete actions are only available to accounts with developer privileges.
Getting Here
- Open the Developer portal.
- In the sidebar, open the Identity group.
- Click Departments.
Departments List
The list is a table of departments with the following columns:
| Column | Description |
|---|---|
| Name | The department's name. |
| Description | The department's description (a dash — is shown when empty). |
| Company | The company the department belongs to (a dash — is shown for global departments). |
| Type | Global (with a globe icon) or Company. |
| Roles | The number of roles in the department. |
| Users | The number of users in the department. |
Click any row to open that department's detail page.
Searching
Use the search box to find departments. You can search by:
- Name
- Description
Filtering
| Filter | Options |
|---|---|
| Company | Pick a specific company, or choose Global (No Company) to show only global departments. |
Department Details
Click any row in the list to open the department's detail page. It is organized into these sections:
- Department Information — Name, Description, Company (shows None (Global) when the department is global), and Type (a Global or Company badge).
- Statistics — the number of Roles and the number of Users in the department.
- System Metadata — the Department ID and the Created date.
- Roles in Department — a table of the roles that belong to this department, with a Company column. Click a role to open its role page.
From the detail page you can use the Edit and Delete buttons in the top right.
Form Fields
The Add and Edit forms share the same Department Information fields:
| Field | Required | Description |
|---|---|---|
| Name | Yes | The department name. |
| Description | No | A short description of the department. |
| Company | No | The company to assign the department to. Leave it empty to make the department global. The list is searchable and can be cleared. |
Common Tasks
Finding a Department
- Go to Developer → Identity → Departments.
- Type a name or description into the search box, or use the Company filter (including Global (No Company)).
- Click a row to open that department's details.
Adding a Department
- On the Departments list, click Add Department (top right).
- Fill in the Department Information:
- Name (required) — enter the department name.
- Description — enter a short description.
- Company — select the company to assign the department to, or leave it empty to create a global department.
- Click Create Department.
On success you are returned to the Departments list and a confirmation message appears.
Leave the Company field empty to create a global department that is available system-wide. Select a company to scope the department to that company only.
Editing a Department
- Open the department's detail page.
- Click Edit (top right).
- Update the Name, Description, or Company.
- Clear the Company field to make the department global, or select a company to assign it.
- Click Save Changes.
On success you are returned to the department's detail page with a confirmation message.
Deleting a Department
- Open the department's detail page.
- Click Delete (top right).
- Confirm in the dialog. This action cannot be undone.
On success you are returned to the Departments list with a confirmation message.
Related Pages
- User Management — Manage users across all companies