artifacts

Text Annotation

A Text Annotation provides additional documentation or explanation about process elements. It adds context, notes, or comments without affecting process execution.

Category
artifacts
BPMN Spec
Section 10.7.2
Icon Class
bpmn-icon-text-annotation

What is a Text Annotation?

A Text Annotation provides supplementary information about process elements. It adds explanatory text, comments, or documentation to clarify process behavior without affecting execution.

Visual Representation

A Text Annotation displays as text with a bracket on the left side. The bracket visually connects the text to its associated element via an Association line.

Key Characteristics

  • Documentation: Adds explanatory notes to diagrams
  • Non-executable: Has no effect on process execution
  • Flexible placement: Can explain any element or group of elements
  • Best practice notes: Often used for rules, tips, or requirements

Common Use Cases

Business Rule Note

Add annotation explaining the business rule evaluated at a gateway decision point.

Compliance Requirement

Document regulatory requirements that an activity must satisfy.

Implementation Note

Provide technical implementation details for developers.

Frequently Asked Questions

Related BPMN Elements

Try this element in Crismo

Create beautiful BPMN diagrams with our modern process modeling platform.