React Diagram - Annotations

Add Meaningful Labels to Diagram Elements

Try Our Live Demo

Syncfusion Feedback

Trusted by the world's leading companies

Explore React Diagram annotation features

Add descriptive labels to nodes and connectors so diagram elements, relationships, and process flows are easier to understand. Position and style annotation text, control label interaction, display multiple labels on one element, and use templates to include custom visual content.

React Diagram labels added to nodes showing names, roles, and statuses

Add labels to nodes

Add annotations to nodes to display names, roles, statuses, values, or other supporting information. This helps each diagram element communicate its purpose without requiring separate documentation. Use node labels when a process step, employee, system component, or other element needs identifying details.

React Diagram labels on connectors explaining relationships and flow

Add labels to connectors

Add annotations to connectors to explain relationships, transitions, conditions, or process flows between diagram elements. This helps readers understand why elements are connected and what each path represents. Use connector labels when a workflow needs to show approval conditions, transition outcomes, or relationship details.

React Diagram precise label positioning with alignment and offset

Position labels precisely

Position node annotations within or around a node, and place connector annotations along a connector path using alignment and offset settings. This provides precise control over label placement and helps keep labels clear and readable. Use these settings when labels must be arranged around crowded nodes or appear at a specific point along a connection.

React Diagram styled and formatted label text with fonts and colors

Style and format label text

Customize annotation text with font, color, alignment, wrapping, background, border, and decoration settings. These options help labels remain readable and match the application’s visual style. Use them when different label types need consistent branding or important information must stand out.

React Diagram runtime interaction with labels on the canvas

Interact with labels in the diagram

Allow users to select, edit, and adjust annotations directly in the diagram, or disable interaction to keep labels fixed. This gives applications control over whether users can change label text or placement. Enable interaction in editable diagrams and disable it when users should only view the configured labels.

React Diagram multiple labels on a single node or connector

Use multiple labels

Add multiple annotations to the same node or connector to present primary text, supporting details, status, or other information together. This keeps related information connected to the diagram element without requiring additional shapes. Use multiple labels when an element must show a name, description, and status in separate areas.

React Diagram annotation template displaying icons with label text

Add custom content with templates

Use annotation templates to display custom HTML or SVG content, such as icons alongside label text. Templates provide additional visual context while keeping annotation content consistent with the diagram design. Use them when labels need status icons, branded content, or visual indicators that plain text cannot provide.

See Why Developers Love Syncfusion

Our Customers Love Us

Having an excellent set of tools and a great support team, Syncfusion reduces customers’ development time. Here are some of their experiences.

Frequently Asked Questions

Annotations are text labels displayed on nodes or connectors. They help describe diagram elements, relationships, conditions, values, and process flow, and multiple annotations can be added to the same element.

Annotation text can wrap onto multiple lines or be clipped and shortened with an ellipsis when it exceeds the available space. Alignment, size, and offset settings can also be adjusted to improve label placement in detailed diagrams.

Yes. Node annotations can be aligned and offset relative to the node’s bounds, while connector annotations can be positioned along a connector path. These settings help place labels where they are easier to read.

Yes. React Diagram supports multiple labels on the same node or connector to show primary text, secondary details, status, or other information. This groups related information in one location without creating additional diagram elements.

Yes. Node annotations add text labels to show names, roles, statuses, or values, while connector annotations explain relationships, transitions, conditions, or flow between connected elements. Using both together creates more complete and understandable diagrams.

Yes. Annotation text can be edited directly in the diagram when editing is enabled. Annotation properties can also be updated while the application is running, allowing labels to reflect changes without recreating the node or connector.

Yes. Annotation templates can display custom HTML or SVG content on nodes and connectors. For example, a template can show an icon alongside label text to help users identify applications, services, databases, and other diagram elements.

Yes. Label interaction can be enabled when users need to select or adjust annotations in the diagram, or disabled when label placement should remain fixed. This allows applications to control whether users can interact with annotations.

Resources

Learn more about our React Diagram

Explore demos, knowledge base articles, and documentation to get the most out of the Diagram.

Documentation

Explore guides, APIs, and quick-start tips

Example demos

See live use cases in action

Community forum

Ask, share, and connect with peers

Knowledge base articles

Find solutions and best practices fast

Contact support

Get expert help when needed

Feature requests and bug reports

Track issues and suggest improvements

See Real Success Stories

Developers around the world trust Syncfusion’s Essential Studio to simplify complex projects and speed up delivery. With a vast library of UI controls, powerful SDKs, and reliable support, Essential Studio helps teams build enterprise-ready applications with confidence.

Read Our Customer Stories

Awards

Greatness—it’s one thing to say you have it, but it means more when others recognize it. Syncfusion® is proud to hold the following industry awards.

Up arrow icon