Skip to main content

DHTMLX Diagram overview

DHTMLX Diagram is a client-side chart component that allows you to display relations between some objects, concepts or living beings in a visual form: as a scheme, chart, organizational chart, mind map, etc. The diagram makes it easier to present tangled and bulky information in a simple and accessible way.

Diagram in the default mode

DHTMLX Diagram provides the possibility to make various diagrams using a predefined set of shapes and connectors, and experiment with their look and feel.

You can choose shapes of desired types, link them by suitable connectors and build any type of a diagram that will show the sequence of some operations making up a particular process, like this:

Data Planning ModelVertical Decision TreeWide Flowchart
Decision TreeActivity Diagram

Custom shapes

You can easily create your own templates of shapes and use them to design any diagram you need. For example, it is possible to create such famous types of custom diagrams as:

Life Cycle DiagramVenn DiagramUML Class Diagram
Network DiagramGame levels and locations


You can draw simple or more complicated schemes by grouping shapes in different ways with the help of such an element of Diagram as a group. It is possible to create as one-level groups as nested groups, to configure their appearance and behavior. Check the details in the Configuring groups article.

Diagram. Default mode. Virtual private cloud architecture


Usage of swimlanes of the DHTMLX Diagram library lets you represent any process (be it a business process, manufacturing or service one, and any other processes) or its separate parts from start to finish. Check the details in the Configuring swimlanes article.

Diagram. Default mode. Swimlane template

Title of lines

The title of Line is enabled in the default mode of Diagram. You can add the text by double-clicking on a line. Use double-clicking also for editing the text.

Diagram in the org chart mode

There is also an org chart mode of Diagram that presents a set of shapes connected by lines in a hierarchical order.

Assistant and partner shapes

A parent shape of any level can have assistant or partner items. The assistant and partner shapes can't be parent items. The assistant and partner items can be added in the editor or by preparing a data set.

In the hierarchical order, the assistant items are displayed between parent and children shapes.

Diagram editor. Org chart mode. Basic initialization

The connection between parent shape and its partner items is always horizontal. Also, the connections between parent shape and all its children become horizontal when you add the partner item for a parent, even if the connections were vertical before.

The partner shapes are very useful for building a family tree.

Related sample: Diagram editor. Org chart mode. Family tree

Here are examples of how the connections of parent shapes look like with one, two, three, and four partners.

One partnerTwo partners
Three partnersFour partners

Custom shapes

An example of adding custom shapes for creating a diagram to present the hierarchical organizational structure of a medical institution:

Diagram. Org chart mode. Medical hierarchy diagram template

Diagram in the mindmap mode

The mindmap mode is used to represent a core topic or idea surrounded by the branches of the subtopics.

Diagram. Mindmap mode. Emotions mind map

The shapes are connected by curved lines and arranged around a central shape of the diagram.

Custom shapes

An example of adding a custom template into the mindmap mode of the diagram to create a site map:

DHTMLX Diagram provides you with a set of API that you can apply in order to make working with a Diagram more convenient. For example, you can implement a feature of searching a shape on request that helps you to simplify work with large diagrams.

Diagram scale

You can apply the zoom template to your diagram to be able to change its appearance via zooming the diagram in or out. Besides, you can make it possible to user to get the detailed information on the selected shape.

What's next

Now you can learn about using DHTMLX Diagram Editor in your application. Read the Diagram Editor overview to get more about this tool.