Templates

Design

Choose how employee boxes look in the current template.

In the Design section, you can select a built-in theme, choose a box layout, create a new custom theme, or customize an existing theme. Theme customization includes colors, fonts, box size, borders, shadows, and other appearance settings.

Design settings for Org Chart templates

Themes

Use themes to control the overall appearance of employee boxes.

You can select one of the built-in themes, create a new custom theme, or customize an existing one. When you edit a built-in theme, Org Chart saves the result as a separate custom theme.

Theme selection in Org Chart templates

Theme settings let you configure box colors, fonts, dimensions, borders, shadows, and other visual properties.

Custom theme settings in Org Chart templates

Note

The selected theme is applied to all boxes in the current template by default. Conditional styles are applied only to boxes that match their conditions and override the general theme where applicable.

Boxes layout

Choose how content is arranged inside employee boxes.

Each layout defines the position of the photo and text fields inside the box. Select the one that best matches your template design.

Box layout options in Org Chart templates

Content

You can customize templates for three Org Chart elements:

  • Boxes

  • Tooltips

  • Search

Each element has its own tab, but the editing process is similar in all of them.

In this article, we use Boxes as an example. The same approach applies to Tooltips and Search templates.

Boxes template settings in the Org Chart configuration wizard

Editor modes

You can edit each template in one of two modes:

Use Preview to check your changes before saving them.

Constructor

The Constructor mode lets you build a template without writing code.

In this mode, you can:

  • add fields to the template,

  • drag and drop fields to change their order,

  • choose how each field is displayed,

  • remove fields you do not need.

To add a field, click Add field and select a field from the list.

Add a field to the Org Chart template

After adding a field, it appears in the template editor. You can drag and drop fields to reorder them.

Each field also has a Display as property that controls how the field is rendered.

Display as options for a template field

The following display types are available:

Type

Description

date

It will be displayed as a date.

date and time

It will be displayed as a date with time.

e-mail

It will be displayed as a mailto link.

link

It will be displayed as a link.

Once you choose link as a display type, a tooltip will appear. This tooltip allows you to:

  • select another field that will be used as a URL for the link

  • specify a custom URL manually

Display as link

MS Teams

It will be displayed as a link that opens a Microsoft Teams chat with the selected user. For example, if you select the “Work email” field as a source for the MS Teams link, the Org Chart will open a chat with the user whose email is specified in that field.

phone

It will be displayed as a phone number.

rich text

It will be displayed as rich text (content that can include formatting such as bold text, colors, and other styling using HTML tags).

tags

It will be displayed as multiple separated tags. You can use this option with:

  • pipe-separated values (“|”) in a text column within a SharePoint list data source:

    Add tags in SharePoint list

    The Org Chart does not support semicolon-separated values yet.

  • multi-choice columns within a SharePoint list data source, where each selected value will be displayed as a separate tag:

    Add tags in SharePoint multi-choice column
  • this also applies to properties like “Skills” and “School & Education” in Entra ID or User Profiles data sources.

text

It will be displayed as plain text (without formatting).

tooltip link

It will show the details tooltip for the current box on click.

This is how the properties look in the Org Chart:

Display as properties

HTML editor

Use the HTML editor mode if you need more advanced customization.

Note

If you switch to HTML editor and save the template in that mode, you will not be able to return to Constructor for that template unless you restore the default template.

In this mode, you can edit the template markup directly using the Handlebars templating engine.

HTML editor for Org Chart templates

The HTML editor also provides the following options:

  • Field names to view available field names,

  • Syntax help to open Handlebars syntax guidance,

  • Restore default to reset the current template to its default version.

A Handlebars template looks like regular HTML with embedded expressions enclosed in double braces, for example {{Title}} or {{Department}}.

For more information, see the HTML templating syntax description.

Note

Go to the next step of the configuration wizard – Conditional styles.