Skip to main content
Annotations are metadata objects that link CDF resources to specific regions or features within files. You can use annotations to mark detected equipment tags in P&IDs, identify objects in images, or tag sections of documents.

How annotations work

An annotation references a file (or file version) and a location within it. The location can be a bounding box, a page range, or another spatial descriptor. Annotations can reference assets, events, or other CDF resources as the annotated entity.

Creation and review

Annotations can be created directly via the API or suggested for review. AI services like engineering diagrams and vision often produce annotation suggestions that you can accept, reject, or modify before storing.
Annotations are stored separately from the file. They persist across file versions when you specify version handling.

Key capabilities

  • Create annotations linking resources to file regions
  • Store suggested annotations for review workflows
  • Query by file, resource, or type
  • Support bounding boxes and page ranges
Last modified on April 23, 2026