Skip to main content
Workspace Logo

Workspace Administration Documentation

Contact Us

How to Manage Organizational Units

Overview​

This guide explains how to create, edit, and delete organizational units in the Organogram Workspace Admin platform. It covers structuring your organization’s hierarchy, updating existing units, and maintaining an accurate organizational record.

Prerequisites​

  • Administrative access to the Organogram Workspace Admin platform
  • Permissions to manage organizational units
  • Basic information about the organizational unit (name, description, optional parent unit)
  • For editing or deletion, knowledge of the specific unit and desired updates

When You Need This

  • Structuring your organization’s hierarchy (e.g., departments, teams, or divisions)
  • Adding new departments or teams to the system
  • Updating or reorganizing units to reflect organizational changes
  • Removing obsolete or redundant organizational units
  • Maintaining accurate records for compliance and auditing

Managing Organizational Units

Step 1: Access the Organizational Unit Management Section​

  1. Log into your Organogram Workspace Admin platform at admin.organogram.app.

    Home Page

  2. In the left sidebar, click Directory > "Organizational Units" to navigate to the organizational unit page.

    Note: If this is your first time, the page will display a message stating "no unit has been added yet".

    Units page - Display available units


Creating an Organizational Unit​

Step 2: Navigate to Add New Unit​

  1. On the Organizational Units page, check the top of the screen for the Add New button.

  2. locate and click the "+ Add New" button to open the organizational unit creation form.

    Create Unit button


Step 3: Fill in the Organizational Unit Information​

  1. The "Create Unit" dialog box will appear with the following fields:

    New Unit creation

    Required Information:

    • Name: Enter the name of the organizational unit (e.g., "Human Resources", "Marketing Team").
    • Planned Head Count: Input the projected number of people for this unit.
    • Unit Head: Specify the leader or manager of the unit.
    • Unit Type: Define the category of the unit (e.g., Department, Team).
    • Parent Unit: Select a parent unit from the dropdown (if applicable).

    What is a Parent Unit? A Parent Unit is the organizational unit that sits above the current unit in the hierarchy. Select a Parent unit if you want this unit to belong under an existing unit. Leave it empty if this is a top-level unit with no parent.

    Note: For the first organizational unit, the Parent Unit dropdown will be empty. For subsequent units, select an existing unit as the parent, if desired.


Step 4: Complete the Form​

  1. Fill in all required fields carefully.
  2. Ensure the unit name is unique and descriptive.
  3. Verify the head count and unit head are accurate.
  4. For subsequent units, ensure the selected parent aligns with the intended hierarchy.

Step 5: Save the Organizational Unit​

  1. Click the "Save" button at the bottom of the dialog.
  2. A notification will pop up saying "Unit Created Successfully".
  3. The system will process the information and create the unit profile.
  4. The dialog will close automatically upon successful creation.

Step 6: Verify Organizational Unit Creation​

  1. You’ll be returned to the main Organizational Units page, which now displays a "Chart" section showing a diagram of your hierarchy.

  2. Next to the "+Add" button, you will find a Toggle. Click it to switch from the chart diagram to the List view.

  3. In the List section, the new unit should now appear.

    Unit Successfully Created

Successful Creation Confirmation:

  • Unit displays in both Chart and List views.
  • Add button remains available for creating additional units.

Next Steps

  • Update the organizational hierarchy as needed.
  • Review the unit’s details for accuracy.

Editing an Organizational Unit​

Step 1: Locate the Organizational Unit​

  1. On the Organizational Units page, ensure you are in the List view (using the toggle next to the add button).

  2. Click the three-dot menu (⋮) on the right side of the unit’s row and select "Edit".

    Units Action Menu

  3. The "Edit Unit" dialog box will appear.

    Units Edit Dialog


Step 2: Update Organizational Unit Information​

Editable Fields:

  1. Name: Modify the name of the unit (e.g., "Human Resources" → "HR Department").
  2. Planned Head Count: Adjust the projected number of personnel.
  3. Unit Head: Update the assigned leader for the unit.
  4. Unit Type: Change the category of the unit if necessary.
  5. Parent Unit: Select a parent unit from the dropdown (if applicable).

Step 3: Complete the Form​

  1. Make the necessary changes carefully.
  2. Ensure the name follows your organization’s naming convention.
  3. Confirm any parent unit changes align with the hierarchy.

Step 4: Save the Changes​

  1. Click the "Save" button at the bottom of the dialog.
  2. A notification will appear: "Organizational Unit Successfully Updated".
  3. The dialog will close automatically upon success.

Step 5: Verify Organizational Unit Update​

  1. You’ll be returned to the main Organizational Units page.
  2. The updated unit will appear with the new details.

What You’ll See After Updating

  • Updated name and description.
  • Updated planned head count.
  • Updated unit head.
  • Updated unit type.
  • Updated parent unit,if changed

Next Steps

  • Verify user assignments to the updated unit.
  • Notify relevant team members.
  • Review hierarchy for accuracy.

Deleting an Organizational Unit​

Step 1: Locate the Organizational Unit​

Note Units with child units cannot be deleted. You must first unassign or delete all child units before deleting the parent unit. Attempting todelete a unit with child units will return a system error.

  1. From the List view on the Organizational Units page, find the unit you want to delete.

  2. Click the three-dot menu (⋮) and select "Delete".

    Units Action Menu


Step 2: Confirm Deletion​

  1. Ensure the correct unit is selected.

  2. A confirmation dialog will appear warning about deletion.

    Delete Confirmation Dialog

  3. Click the red "Yes" button to confirm.


Step 3: Verify Unit Deletion​

  1. A notification will pop up saying "Unit Successfully Deleted".
  2. The system will process the deletion and remove the unit.
  3. You’ll be returned to the main Organizational Units page.

What You’ll See After Deleting

  • The unit will be removed from the directory list and chart.
  • Unit count will decrease.
  • Any affected child units or user assignments will update based on hierarchy rules.

Next Steps

  • Verify user assignments for affected units.
  • Notify relevant team members.
  • Review the hierarchy for accuracy.