Skip to main content

Labeling, Chats and Guidance

Learn about some of the concepts and drive the way you work with Kodexa

Updated today

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:

  1. Navigate to the Workspace and open a document

  2. Click and drag to select the text you want to label

  3. 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

Did this answer your question?