Managing Codes¶
Codes are labels you apply to segments of your data. They help categorize and analyze patterns in your research.
Understanding Codes¶
A code represents a concept, theme, or category in your data. Each code has:
- Name - A descriptive label (e.g., "Positive Experience")
- Color - Visual identifier for highlighting
- Memo - Optional notes about the code's meaning
Creating Codes¶
Create a New Code¶
- In the Coding screen, press
N(or click the + button) - Enter a code name
- Select a color from the palette or enter a custom hex color
- Optionally add a description
- Click Create Code

Tip: Hex Colors
Hex colors start with
#followed by 6 characters (e.g.,#FF5733).
Organizing Codes¶
Create Categories¶
Categories group related codes into a hierarchy:
- Click Create Category
- Enter a category name
- Optionally select a parent category for nesting
- Add an optional memo to describe the category
- Click Create

Hierarchy Example¶
Emotions (category)
├── Positive (code)
│ ├── Joy (code)
│ └── Gratitude (code)
└── Negative (code)
├── Frustration (code)
└── Disappointment (code)
Editing Codes¶
Rename or Recolor¶
- Right-click a code in the code list
- Select Edit
- Modify the name, color, or memo
- Click Save
Add a Memo¶
Memos help document what a code means and when to use it:
- Right-click a code
- Select Edit Memo
- Enter your description
- Click Save
Tip: Good Memo Practice
Include: - Definition of the code - Examples of when to apply it - Boundaries (what it doesn't include)
Deleting Codes¶
- Right-click a code and select Delete
- If the code has coded segments, you'll see a warning with options:
- Delete code only - Removes the code but keeps segments (they become orphaned)
- Delete code and segments - Removes both
- Click Delete to confirm

AI-Assisted Code Management¶
Suggest New Codes¶
The AI can analyze your data and suggest new codes:
- Click AI > Suggest Codes
- Review the suggestions (each shows name, description, and confidence level)
- Click Approve to add a code, or Reject to dismiss

Detect Duplicate Codes¶
Over time, similar codes may accumulate. The duplicate detector helps clean up:
- Click AI > Find Duplicates
- Review candidate pairs (each shows code names, similarity percentage, and segment counts)
- Click Merge A → B to combine codes, or Dismiss if they're not duplicates

Best Practices¶
Code Naming - Use clear, descriptive names - Be consistent with verb tense ("Expressing" vs "Expressed") - Avoid overly long names
Color Usage - Use similar colors for related codes - Reserve bright colors for important codes - Consider colorblind-friendly palettes
Categories - Don't over-categorize early - Let categories emerge from your data - Reorganize as your understanding grows
Next Steps¶
With your coding scheme ready: