Overview
Kodexa's document labeling system enables you to efficiently highlight, categorize, and extract information from documents. When you select text in a document, a popup appears with labeling options, chat templates, and tools to help you work with the content.
Opening the Label Popup
To begin labeling:
Navigate to the Workspace and open a document
Click and drag to select the text you want to label
The label popup appears automatically at your selection
Popup Actions
Properties
Click the Properties button to open the properties panel for the selected content. This shows detailed information about the selection including node structure and features (available to users with developer tools enabled).
Copy to Clipboard
Click the Copy button to copy the selected text to your clipboard for use elsewhere.
New Data Element
Click New Data Element to add the selected text as a new field in your Data Definition (available to users with developer tools enabled). This creates a new label that can be reused throughout your project.
Searching for Labels
Basic Search
Type in the search box to find labels by name. The system shows matching labels from both your Data Definition and AI models.
Advanced Search Modifiers
Use special characters to filter label results:
` (backtick) - Show only labels from AI models/assistants
~ (tilde) - Show only labels from your Data Definition
? - Display help information about searching
Example: Type `invoice to see only model labels containing "invoice"
Message Templates and Chat
When no search query is entered, the popup shows available message templates with an orange chat icon. These templates allow you to:
Start conversations about the selected content
Ask questions about what the text means
Get help understanding the document
Click a message template to send it to the chat. If the template requires additional information, you'll be prompted to fill in options before sending.
Working with Labels
Viewing Selected Labels
The popup shows all labels currently applied to your selection, organized by:
No Confidence Tags - AI-suggested labels that match your selection but need confirmation
Selected Tags - Labels already applied to this content
Adding Labels
Labels are organized into groups:
Top-Level Labels - Root labels from your Data Definition
Data Object Labels - Labels grouped by data objects (invoice fields, customer info, etc.)
Click any label with a plus icon to apply it to your selection. The label is immediately saved and the popup closes.
Removing Labels
To remove a label:
Click the colored box with minus icon next to the label name
The label is immediately removed from your selection
If you have more than 3 labels selected, a Clear Selected Labels option appears to remove all labels at once.
Viewing Label Details
For users with developer tools enabled, click "View Feature Metadata" under any label to see detailed technical information about the label including:
Feature properties
Confidence scores
Tag structure
Opening Label Definitions
Click the book icon next to a label to open its definition in the Data Definition panel. This shows the label's configuration, properties, and how it's used across your project.
Label Indicators
Model Badge
Labels marked with a blue "Model" badge were suggested or created by AI assistants. These labels come from trained models rather than manual labeling.
Parent Labels
Some labels show their parent label name beneath them, indicating they belong to a hierarchical structure. For example, "Invoice Number" might be under the parent "Invoice Header".
No Confidence Tags
When AI models detect labels with low confidence that match your selected text, they appear in a special section. These are suggestions that:
Match the text you selected
Have low confidence from the model
May be relevant but need your confirmation
Click the replace icon on a no confidence tag to apply it to your selection.
Locked Documents
If a document is locked, the label popup shows only the selected text and a copy button. You cannot add or remove labels from locked documents.
Test Results
When labeling in a test result (execution result), a red warning appears indicating that labels cannot be saved. This prevents accidentally labeling test data that will be discarded.
Data Definition Panel
The Data Definition panel on the left side of the workspace shows the complete structure of labels available for your project. You can manage label properties, hierarchies, and configurations from this panel.
Best Practices
Use Search Modifiers - Filter by ` or ~ to quickly find the right label type
Review AI Suggestions - Check no confidence tags for helpful label recommendations
Organize Hierarchically - Group related labels under parent labels for better organization
Use Message Templates - Start chats about confusing content to get AI assistance
Clear Multiple Labels - Use bulk clear when you need to relabel content
Tips
The popup auto-focuses the search box for quick typing
Press Esc to close the popup without making changes
Labels are saved immediately when applied
Use the Properties button to see technical details about your selection
Message templates appear only when the search box is empty
Type ? in the search box to see help information
