Getting started
Configuration wizard
- Open configuration wizard
- Data source
- Views
- Templates
- Conditional styles
- Vacancies
- Custom code
- General
HTML templates
JavaScript framework
Additional resources
- Video: Introducing Plumsail Org Chart
- Data caching
- SharePoint Server 2019/SE (On-Premises) resources
- Make sure that SharePoint has enough data
- Exporting properties to a directory service
General
- Version history
- Licensing details
- Data protection and security
- Custom code security measures
- Billing and subscription management
Printing & Reports
- Printing organizational structure
- Generate multi-page PDF report
- Export to CSV and analyze in Excel
- Custom styles for printed Org Chart
Microsoft Teams
Display different types of employees
Filter and order boxes
- Create and manage filtered views
- Order employees boxes using a custom field
- Group employees boxes using a custom field
Customize boxes and styles
- Format boxes conditionally
- Customize box HTML template and CSS styles
- Display awards and conditionally format Org Chart
- Create an Org Chart with two root managers
- Change Org Chart theme
- Localize Org Chart
Show specific user on load
- Drill down to specific box using URL parameter
- Drill down to current user by default
- Drill down to manager of user from URL by default
Manage web part size and scale
- Open Org Chart in full-screen mode on load
- Make Org Chart use full page width
- Automatically scale boxes to fit visible area
Other examples
- How to customize Org Chart
- How to use advanced Org Chart navigation
- Use tenant properties to disable Org Chart features
- Include and use fields from additional list in Org Chart
- Support of search in a list with more than 5000 items for Org Chart
- Show Org Chart based on a list data source for anonymous users
- How to check if a user has Tenant Administrator permissions
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.
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.
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.
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.
Your vacancies are displayed in a table, which makes it easy to view and manage all open positions.
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.
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.
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:
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.
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.
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.
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.
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.
Unfold the Advanced settings and enable vacancies.
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.Click Finish to save your settings.
Now the More menu contains a new option called Manage vacancies. It opens the vacancies list in a new tab.
Click New, name the position, and specify the department and manager information.
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
UserPrincipalNameattribute. 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.