CSV Import/Export

The Business Glossary supports bulk import and export via CSV, making it easy to migrate terms from spreadsheets, other tools, or between spaces.

Exporting

1. Navigate to the Glossary section in your space
2. Click Export CSV
3. A file named glossary.csv is downloaded

CSV Format

The exported file contains the following columns:

Column	Description
name	Term name
slug	URL-friendly identifier
definition	Term definition (plain text)
category	Category grouping
status	draft, approved, or deprecated
synonyms	Pipe-separated list of synonyms

Example

name,slug,definition,category,status,synonyms
Annual Recurring Revenue,annual-recurring-revenue,"Total annualized subscription revenue.",Finance,approved,ARR
Churn Rate,churn-rate,"Percentage of customers who cancel in a period.",Marketing,draft,Attrition Rate|Customer Churn

Importing

1. Prepare a CSV file following the format above
2. Navigate to the Glossary section
3. Click Import CSV and select your file

Import Behavior

• Upsert by slug — If a term with the same slug already exists, it is updated with the values from the CSV. New slugs create new terms.
• All columns are optional except name — Missing columns default to empty values. The slug is auto-generated from the name if not provided.
• Status defaults to draft — If the status column is omitted, imported terms are created as drafts.

Response

After import, you'll see a summary:

{
  "created": 12,
  "updated": 3,
  "errors": 0
}

Tips

• Start with export — If you already have some terms, export first to get a template with the correct column headers.
• UTF-8 encoding — Ensure your CSV file is saved with UTF-8 encoding to support special characters.
• Bulk migration — Use CSV import to migrate glossaries from other governance tools or shared spreadsheets.