Display vacancies for Org Chart in SharePoint and Microsoft Teams

Note

For SharePoint Server 2019/SE, please follow this instruction.

Org Chart lets you add vacancies to your organizational structure, making it easy to visualize open positions alongside existing employees. Use vacancies to plan future hires, propose new roles, or indicate positions that need to be filled after an employee leaves.

Plumsail Org Chart displaying vacancies

Vacancies are stored separately from your main data source, so you do not need to change your employee data. This article explains how to configure permissions, create and manage vacancies, and migrate from the previous SharePoint list version. For setup and storage settings, see the Vacancies step of the configuration wizard.

Enable vacancies

Before creating vacancies, enable them in the Vacancies step of the configuration wizard and configure vacancy permissions. Save the step to apply your settings.

For a different storage location or to share vacancies between charts, see Advanced settings. If you already used vacancies before version 4.3.6, follow the Migration instructions below.

Configure vacancy permissions

Vacancies may contain sensitive information, such as plans to replace an employee. Configure access to the document library where vacancies are stored to control who can view and edit them.

Open the Vacancies step in the configuration wizard and click Manage permissions to open the SharePoint permissions page for the configured document library.

Vacancies permissions settings and Manage permissions button

In this example, permissions apply to the Org Chart Assets document library on the HR Department site. Review the library’s permissions and restrict access as needed.

Vacancies permissions settings in SharePoint

To manage permissions separately from other chart assets, choose a different document library in Advanced settings. Save the Vacancies step after configuring it.

Manage vacancies

Once vacancies are enabled, use the Manage vacancies option in the chart menu to create, edit, and remove them.

Plumsail Org Chart with open menu, highlighting the Manage vacancies option

Your vacancies are displayed in a table, which makes it easy to view and manage all open positions.

Plumsail Org Chart vacancy management view

The table includes the following columns:

  • Job title: The name of the position.

  • Vacancy type: Classifies the position as New position or Replacement.

  • Role context: Automatically populated based on the hierarchy relationships you configure, such as manager, subordinates and replacements.

  • Department: The department, team, or group where the vacancy belongs.

  • Description: Additional information about the vacancy, such as notes for your team.

Create a new vacancy

Click + Create new above the table to configure a new vacancy. If you have not created any vacancies yet, you will find the same option in place of the table.

Plumsail Org Chart vacancy management view with no vacancies

A side panel opens. The available options depend on the selected vacancy type:

  • Vacancy type: Select New position or Replacement.

  • Job title: Enter the name of the position.

  • Manager: Select the manager from the list of available employees. Available for new positions only.

  • Subordinates: Select the employees or vacancies who should be placed under the vacancy. Available for new positions only.

  • Former employee: Select the employee whose position the vacancy will replace. Available for replacements only.

  • Department: Specify the department, team, or group where the vacancy belongs.

  • Description: Add additional information about the vacancy, such as the deadline for filling the position.

Plumsail Org Chart vacancy creation form

Use the vacancy types to represent different cases:

  • New position represents a new role in your company. It can have a manager and its own subordinates.

  • Replacement represents a role that is currently held by an employee, but is open for recruitment.

For example, let’s say an employee is leaving your Finance team soon:

Plumsail Org Chart before adding a replacement vacancy

We create a new Replacement vacancy and select that employee as the former employee. Once it is added, the vacancy will take the employee’s place in the chart.

Plumsail Org Chart after adding a replacement vacancy

Since replacement plans can be sensitive, review vacancy permissions to control who can view and edit them.

Edit vacancies

Hover over an existing vacancy in the table to see the Edit, Duplicate, and Delete actions.

Plumsail Org Chart vacancy management view, highlighting the editing options

Migration

If you previously used SharePoint lists to add vacancies to your chart, you can migrate to the new vacancy management feature in a few steps.

After the update, a note is shown when you reopen the chart. It includes the steps needed to migrate your existing vacancies to the new document library.

Plumsail Org Chart information note about the new vacancies version

Open the Vacancies step and review vacancy permissions, even if you do not plan to change them.

After that, you must save the step in the configuration wizard for all settings to be applied to the chart.

The Manage vacancies option is now available in the chart menu.

Plumsail Org Chart with open menu, highlighting the Manage vacancies option

All your existing vacancies are migrated automatically, but the original list remains on your SharePoint site. You can remove it once you have verified the results.

Vacancies in version 4.3.5 and earlier

In version 4.3.5 and earlier, vacancies are stored in a SharePoint list that you configure in the Data source step.

  1. Unfold the Advanced settings and enable vacancies.

  2. Enter the server-relative URL of the list that Org Chart will use to pull data from, for example /sites/CompanyHub/Lists/Vacancies. If the list already exists, Org Chart will use it. Otherwise, it will be created automatically.

  3. Click Finish to save your settings.

Org Chart vacancies configuration

Now the More menu contains a new option called Manage vacancies. It opens the vacancies list in a new tab.

Vacancies data source link

Click New, name the position, and specify the department and manager information.

New vacancy

The Manager field must contain the Employee ID of the corresponding manager. It is mapped according to the Org Chart data source configuration:

  • User profiles: Org Chart uses the account name as the employee ID. In SharePoint Online, it looks like user@tenant.onmicrosoft.com.

  • Entra ID: Use the UserPrincipalName attribute. In most cases, the UPN is the user’s email address, for instance: user@tenant.onmicrosoft.com.

  • SharePoint list or Excel / CSV: Use the values from the column you chose as the employee ID. It can be anything, such as a title, email address, or ID.