# Black Ice Documentation

## getting-started

### Getting started

- [Welcome to Black Ice](/docs/getting-started/welcome) — Learn what Black Ice is and how it helps manage product terminology.
- [How Black Ice works](/docs/getting-started/how-black-ice-works) — A one-page picture of how decisions flow from your team to your tools, and where your data lives.
- [Plans and pricing](/docs/getting-started/plans-and-pricing) — Compare Free, Pro, and Builder plans for Black Ice.
- [Best practices](/docs/getting-started/best-practices) — Tips for structuring your ontology and managing terminology effectively.
- [Quick start](/docs/getting-started/quick-start) — A step-by-step guide to creating your first concept in Black Ice.
- [Getting started with AI](/docs/getting-started/getting-started-ai) — Connect your Black Ice ontology to AI models in minutes.

### Reference

- [FAQ](/docs/getting-started/faq) — Answers to common questions about Black Ice.
- [Glossary](/docs/getting-started/glossary) — Definitions of key terms used in Black Ice.
- [Support](/docs/getting-started/support) — How to get help with Black Ice.
- [Security & data protection](/docs/getting-started/security-and-data-protection) — How Black Ice stores and isolates workspace data, our no-model-training commitment, retention, and how to request the DPA.

## features

### Core Concepts

- [Classes](/docs/features/classes) — How Black Ice structures your product terminology as a connected ontology.
- [Concepts & IDs](/docs/features/concepts-and-ids) — How concepts and auto-generated IDs work in Black Ice.
- [Semantic relationships](/docs/features/semantic-relationships) — How semantic relationships connect concepts in your ontology.
- [Knowledge graph](/docs/features/knowledge-graph) — Visualize your ontology with the interactive knowledge graph.
- [Custom fields](/docs/features/custom-fields) — Extend your ontology with custom metadata fields on concepts and terms.

### Terminology

- [Source & target terms](/docs/features/source-and-target-terms) — How to manage multilingual terms, culture guidelines, and approval workflows.
- [Batch availability updates](/docs/features/batch-availability-updates) — Update availability across many concepts at once.
- [Market availability](/docs/features/market-availability) — Track term-level readiness across locales with availability statuses.
- [Candidate review workflow](/docs/features/candidate-review-workflow) — Review extracted terms against five tests before they earn a place in the ontology.

### Markets

- [Locales & markets](/docs/features/locales-and-culture-dna) — Managing locales, source markets, and brand identity per region.
- [Market definitions](/docs/features/market-definitions) — Define voice, tone, grammar, and cultural conventions for each locale.
- [Brand identity per market](/docs/features/brand-identity-per-market) — Localize your brand name, tagline, and positioning per locale.
- [Reference markets](/docs/features/reference-markets) — Mark a market as a reference language you use internally but don't ship products in.

### Collaboration

- [Workspaces](/docs/features/workspaces) — How to collaborate with your team using workspaces, roles, and activity tracking.
- [Team management](/docs/features/team-management) — Invite team members and manage roles and permissions.
- [Approval workflows](/docs/features/approval-workflows) — Send terms for external review with shareable approval links.

### Import & Export

- [CSV & Excel import](/docs/features/csv-and-excel-import) — Import terminology from CSV or Excel files with column mapping and conflict resolution.
- [Export formats](/docs/features/export-formats) — Export your ontology as JSON, Markdown, CSV, PDF, AI Agent Bundle, or RDF/OWL (Turtle and JSON-LD) — and when to use each.
- [Restoring an ontology from a bundle](/docs/features/ontology-restore) — Rebuild a workspace from an exported ZIP bundle or from the GitHub repository that GitHub Sync writes to.

### Activity & Notifications

- [Activity log](/docs/features/activity-log) — Audit trail of every change made in your workspace.
- [Notifications & alerts](/docs/features/notifications) — Customize what you get notified about and when.

### Workspace & Account

- [Permissions & data visibility](/docs/features/permissions-and-data-visibility) — Control who can approve and what reviewers see.
- [Account & security](/docs/features/account-and-security) — Manage your sign-in, password, and account deletion.

### Translation Policy

- [Translation policy](/docs/features/translation-policy) — Decide what gets translated, what stays in English, and how to override per market.

## integrations

### Overview

- [Integrations Overview](/docs/integrations/integrations-overview) — Connect Black Ice to your AI localization pipeline via GitHub Sync, MCP, REST API, or Workspace API. Compare paths and pick the right one for your team.

### GitHub Sync

- [GitHub Sync](/docs/integrations/github-sync) — Push your ontology to GitHub as a structured markdown bundle for AI agents and programmatic consumption.

### AI Integrations

- [Black Ice + AI: What Your Ontology Unlocks](/docs/integrations/ai-integrations-overview) — How to feed your Black Ice ontology to Claude, ChatGPT, Gemini, and local models via MCP, the REST API, or GitHub Sync — with a comparison of access paths.
- [Connect Claude to your workspace (step by step)](/docs/integrations/connect-claude-mcp) — Step-by-step guide with screenshots: add Black Ice as a custom connector in Claude, authorize the workspace over OAuth, and start asking Claude about your terminology.
- [Connect Cursor and other MCP clients](/docs/integrations/connect-cursor-mcp) — Connect Cursor, VS Code, and other MCP clients to your Black Ice workspace over the remote MCP server.
- [Connecting MCP clients to Black Ice](/docs/integrations/claude-desktop-mcp) — Connect Claude Desktop, Claude Code, Cursor, and other MCP clients to your Black Ice workspace to check approved terms and market availability live.
- [API Reference](/docs/integrations/api-reference) — Read and write your workspace ontology programmatically — endpoints, auth, schemas, and a downloadable full reference.
- [API & MCP rate limits](/docs/integrations/rate-limits) — Per-plan throughput caps for the MCP server and Workspace API, response headers, and how to design pipelines around them.
- [Switching the workspace Claude or Cursor uses](/docs/integrations/switch-mcp-workspace) — Force an MCP client to re-authorize against a different workspace.

### Workspace API

- [Workspace API access](/docs/integrations/workspace-api-access) — Read and write your ontology programmatically from external tools.
- [Pulling the ontology into your stack (integration guide)](/docs/integrations/ontology-pull-integration) — Step-by-step guide for pulling your Black Ice ontology into an external system over the read API: read-only keys, pagination, incremental sync, rate limits, and errors.
- [Managing and troubleshooting API keys](/docs/integrations/api-key-management) — Create, rotate, revoke, and debug Workspace API keys, including the meaning of 401, 403, and 429 responses.
- [Privacy by design in Black Ice integrations](/docs/integrations/privacy-by-design-integrations) — How to connect Black Ice while minimizing data movement, using read-only access, and keeping customer ontology data out of model training.