Skip to main content

Manage Glossary Terms

View, download, and manage your glossary term pairs in Scriptix.

Viewing Glossaries

Glossaries List

The main Glossaries page displays all your glossaries in a data grid:

Columns Shown:

  • Name - Glossary name (clickable)
  • Language Pair - Source → Target language (e.g., "en → nl")
  • Entry Count - Number of term pairs in glossary
  • Status - Active or Inactive
  • Created At - Creation date

Glossary Actions

Each glossary has three action buttons (via action menu):

Edit (Pencil Icon):

  • Opens Edit Glossary modal
  • Update glossary name
  • Change description
  • Toggle active/inactive status

Download (Download Icon):

  • Downloads glossary entries as CSV file
  • File named: [name]_glossary.csv (spaces replaced with underscores)
  • Contains all source→target term pairs
  • Success toast: "Glossary entries downloaded successfully"
  • Error toast: "Failed to download glossary entries"

Delete (Trash Icon):

  • Opens Delete Glossary confirmation modal
  • Shows glossary details
  • Warning message
  • Permanently removes glossary

Editing a Glossary

Edit Glossary Modal

  1. Click Edit icon (pencil) on any glossary
  2. Edit Glossary modal opens (medium size)
  3. Shows current values pre-filled
  4. Update the following fields:

Name:

  • Text input
  • Maximum 100 characters
  • Optional (can leave as is)

Description:

  • Multiline text input
  • Optional field
  • Can update or leave blank

Active Status:

  • Checkbox control
  • Label: "Active"
  • Check = Active
  • Uncheck = Inactive

Important Note:

  • Gray info box displays: "Glossary entries cannot be edited"
  • Source language cannot be changed
  • Target language cannot be changed
  • Term pairs cannot be edited directly

Save Changes

  1. Review updated information
  2. Click "Update" button (primary variant)
  3. Success toast: "Glossary updated successfully"
  4. Modal closes automatically
  5. List refreshes with updated values

Update Button:

  • Disabled while loading
  • Type: submit
  • Variant: primary
  • Label: "Update"

Cancel Button:

  • Closes modal without saving
  • Variant: smoke
  • Label: "Cancel"

Active vs Inactive Status

Active Glossaries (is_active: true):

  • Checkbox checked
  • Glossary available for use
  • Shows as "Active" in list

Inactive Glossaries (is_active: false):

  • Checkbox unchecked
  • Glossary preserved but not usable
  • Shows as "Inactive" in list

Use Cases for Inactive:

  • Temporarily disable glossary
  • Keep for future use
  • Archive old versions
  • Testing new glossaries

Downloading Glossary Entries

Download from List

  1. Locate glossary in list
  2. Click Download icon (download action)
  3. CSV file downloads automatically
  4. Toast notification confirms success

Download from Details

  1. Open glossary details page
  2. Click Download button in header
  3. CSV file downloads automatically
  4. Same file format as list download

Downloaded CSV Format

File contains two columns:

source_term,target_term
PostgreSQL,PostgreSQL
myocardial infarction,hartinfarct
API,API

File Properties:

  • Format: CSV (text/csv)
  • Filename: [glossary_name]_glossary.csv
  • Encoding: UTF-8
  • Columns: source_term, target_term
  • All entries included

Uses for Downloaded CSV:

  • Backup glossary terms
  • Share with team members
  • Review and audit terms
  • Edit in external tools
  • Create new glossary versions

Deleting a Glossary

Delete Glossary Modal

  1. Click Delete icon (trash) on glossary
  2. Delete Glossary modal opens (small size)
  3. Modal displays:

Confirmation Message:

  • Text from translation key with glossary name

Glossary Details (Gray Box):

  • Name
  • Language pair (source → target)
  • Entry count

Warning (Red Box):

  • Warning message from translation key
  • Indicates permanent deletion

Confirm Deletion

  1. Review glossary information
  2. Click "Delete" button (danger variant, red)
  3. Success toast: "Glossary deleted successfully"
  4. Modal closes
  5. Glossary removed from list
  6. Optional callback executed (if provided)

Delete Button:

  • Variant: danger (red)
  • Label: "Delete"
  • Disabled while loading
  • Type: button

Cancel Button:

  • Closes modal without deleting
  • Variant: smoke
  • Label: "Cancel"

Warning: Deletion is permanent and cannot be undone.

Viewing Glossary Details

Open Details Page

  1. Click glossary name in list
  2. Glossary details page opens
  3. Shows:
    • Breadcrumb navigation
    • Back button
    • Edit, Download, Delete actions in header
    • Glossary information cards
    • Term entries data grid

Information Displayed

Glossary Metadata:

  • Name
  • Language pair
  • Entry count
  • Active status
  • Created date
  • Last modified date

Entries Grid:

  • Data grid with all term pairs
  • Columns: ID, Source Term, Target Term
  • No pagination (shows all entries)
  • No sorting
  • No filtering

Glossary Entries Cannot Be Edited

Important Limitation:

Glossary term entries cannot be edited after creation. This is shown in edit modal with info message.

To Update Terms:

Since entries cannot be edited directly:

  1. Download current glossary as CSV
  2. Edit CSV file externally
  3. Delete old glossary (or keep inactive)
  4. Create new glossary with updated CSV
  5. Activate new glossary

Why This Design:

  • Entries tied to DeepL/Google glossary IDs
  • External service integration
  • Prevents sync issues
  • Ensures consistency

Managing Multiple Glossaries

Organization Strategies

By Domain:

  • Create separate glossaries for different domains
  • Medical, Legal, Technical, Business, etc.
  • Clear naming helps selection

By Project:

  • Project-specific glossaries
  • Client-specific terms
  • Product vocabulary

By Language Pair:

  • One glossary per language pair
  • English → Dutch
  • English → French
  • Etc.

Using Active/Inactive Status

When to Deactivate:

  • Seasonal glossaries (not currently needed)
  • Old versions (keeping as backup)
  • Testing glossaries (before full deployment)
  • Archived projects (keep data but not in use)

When to Keep Active:

  • Currently used glossaries
  • Production glossaries
  • Frequently needed terms

Data Grid Features

Glossaries List

Sorting:

  • Manual sorting enabled
  • Server-side sorting

Filtering:

  • Manual filtering enabled
  • Server-side filtering

Pagination:

  • Manual pagination
  • Server-side pagination
  • Default page size: 25

Actions:

  • Edit, Download, Delete
  • Action menu for each row
  • Icons: Pencil, Download, Trash

Glossary Details

Entries Grid:

  • Shows all term pairs
  • Columns: ID, Source Term, Target Term
  • No sorting
  • No filtering
  • No pagination (all entries shown)

Access Control

Who Can Manage Glossaries:

  • ORGADMIN role users
  • CONTRIBUTOR role users
  • Routes restricted to these roles

Available Actions:

  • Create glossaries
  • Edit glossaries (name, description, status)
  • Download glossaries
  • Delete glossaries
  • View glossary details

Click Behavior

Name Column:

  • Clicking name opens glossary details page
  • Navigate to /glossaries/:glossaryId

Action Buttons:

  • Edit: Opens edit modal
  • Download: Triggers CSV download
  • Delete: Opens delete confirmation modal

Keep your glossaries organized! Regular maintenance ensures optimal accuracy in transcription and translation.

Next Steps