Work with OWL Annotation Properties
- Last Updated: November 20, 2026
- 3 minute read
- Semaphore
- Version 5.13
- Documentation
OWL annotation properties let you add descriptive metadata to ontology elements, such as classes and properties. You can use them to document definitions, record review information, or provide additional context for people working with the ontology.
In Knowledge Model Management (KMM), you can create annotation properties, review their definitions, edit supported details, and use them to annotate ontology elements.
For example, you can create a Review status annotation property and use it to record whether a class has been reviewed or requires further validation.
Assumptions
Before you begin, ensure that:
- You have access to Knowledge Model Management (KMM).
- An OWL model has been created or imported.
- You have the required permissions to modify ontology content.
Method
To work with OWL annotation properties:
- Create an annotation property, if needed.
- Review and edit an annotation property.
- Edit domain and range, if needed.
- Add an annotation to an ontology element.
Create an Annotation Property
Create an annotation property when you need to record metadata that is not already represented by an existing property.
- Open Knowledge Model Management and go to Models.
- Locate the OWL model and select Open Master.
- Select Ontology > Annot props.
- Click the + button in the annotation property explorer.
- In the property creation dialog, enter a Property Name.
- Optionally, select Customize URI to specify a URI for the property.
- Click Save.
The new annotation property appears in the explorer.
Review and Edit an Annotation Property
After creating or opening an annotation property, review its definition and update the supported fields as needed.
- Under Ontology > Annot props, select the annotation property you want to review or edit.
- Open its Overview tab.
- Review its label, description, domain, and range.
- To add a label, click Create a new label. To add a description, click Add a description.
- To modify an existing editable value, click the pencil icon next to the field and make the required change.
- Confirm the change using the control provided in the editor.
- Verify that the updated information appears in the property details.
You can also use the Hierarchy tab to inspect the property's hierarchy and Raw Text to inspect its RDF representation.
The available editing controls depend on the property definition. Some complex OWL expressions may be displayed without being editable.
Edit Domain and Range
You can define or update an annotation property's domain and range using class and datatype suggestions.
- Under Ontology > Annot props, select the annotation property.
- On the Overview tab, click the + icon next to Domain or Range. To edit an existing value, click the pencil icon (Edit Domain or Edit Range).
- Start typing a value:
- For Domain, select a class from the suggestions.
- For Range, select a datatype from the suggestions.
- Click the checkmark to save the change.
- Verify that the selected value appears in the property details.
For example, you can set Domain to Employee and Range to xsd:string.
Add an Annotation to an Ontology Element
After creating an annotation property, you can use it to add metadata to an ontology element.
For example, you can use a Review status annotation property to record the review state of an Employee class.
- Under Ontology, select Classes.
- Select the class you want to annotate, such as
Employee. - Open the Overview tab.
- Click Add an annotation.
- Select the annotation property you want to use, such as
Review status. - Enter the annotation value, such as
Reviewed by documentation team. - Confirm the change using the checkmark.
- Verify that the annotation appears in the class details.
You can add another value to the same annotation property when you need to record additional information.
For example, the Employee class could contain the following values:
| Annotation property | Example value |
|---|---|
Review status |
Reviewed by documentation team |
Review status |
Pending technical validation |
These values are examples of descriptive metadata. They do not automatically implement a review or approval workflow.
Annotations may also be carried into derived SKOS content when supported by the derivation workflow. For more information, see Derive SKOS Concepts from an OWL Ontology.
Outcome
You can create OWL annotation properties, review and edit supported property details, define domain and range values, and use annotation properties to add descriptive metadata to ontology elements.
For the next task, see Work with OWL Classes to manage class details, or Derive SKOS Concepts from an OWL Ontology to derive SKOS concepts from annotated OWL classes.