# Export copy

> Export your finalised copy and translations from KopiMark as JSON, CSV, or XML — or pull them live via the read-only API into your codebase or CMS.

_Source: https://kopimark.com/docs/guides/export-copy/_

KopiMark is where copy is *made*; your codebase or CMS is where it
*lives*. Exports are how you bridge the two. You can export manually as a
download, or — on the right plan — pull live from KopiMark's read API.

## Export formats

KopiMark exports in three formats. Pick whichever your codebase already
speaks:

- **JSON** — best for most product codebases. Keys map to text node ids
  (or your custom export keys), values are the localised strings.
- **CSV** — best for handing copy to non-engineers or for spreadsheet
  review.
- **XML** — best for some legacy localisation pipelines.

## Manual export (every plan)

1. Open the project and go to **Project Settings → Developer**.

2. Pick the format (JSON, CSV, or XML) and any options:
   - **Pretty-print** — readable indentation, slightly larger file.
   - **Flat shape** — a flat key→value map, vs the default nested shape.
3. Pick a **language filter** if you only want one locale at a time. Leave
   it empty to export all.

4. Click **Download**.

That's it for the manual flow. You can filter the export to only include
nodes in specific statuses — usually *Approved* or *Shipped* — so
drafts don't leak into your codebase.

> _[image placeholder: Project Settings → Developer with the format picker and the live endpoint URL preview.]_

## API export (Team and Business plans)

If you'd rather pull live, every project has a read-only API endpoint
that returns the same payload. Your build script can fetch it on every
deploy.

### Generate a token

1. **Project Settings → Developer**, scroll to **API tokens**.

2. Click **Generate new token**. KopiMark shows the token once — copy it
   immediately.

3. Store the token in your build environment, not in source control.

The Developer page shows the live endpoint URL with your current
filters baked in (format, pretty-print, flat shape, language) — copy
that as the base URL for your client.

### Use it from a build

The endpoint accepts your token as a bearer header. Hit it the same way
you'd hit any read-only JSON API; cache it however your build expects.

We've kept the API minimal on purpose. There's a more detailed write-up
in [API and developer
tokens](/docs/guides/api-and-developer-tokens/).

## Status-filtered exports

The most common mistake teams make on their first export is shipping
copy that's still in *Draft*. Two ways to avoid it:

- **Filter by status at export time.** The download dialog lets you pick
  which statuses count.
- **Only the last status counts as "shipped".** Some teams configure their
  status list with *Shipped* (or *Approved*) as the final state, and
  export only that one.

Either pattern works. The export *defaults* to all statuses, so an
explicit filter is wise.

## See also

- [API and developer tokens](/docs/guides/api-and-developer-tokens/)
- [Statuses and approvals](/docs/guides/statuses-and-approvals/)
- [Plans and limits](/docs/reference/plans-and-limits/)

---

## All documentation

_The full docs index, in case the answer lives on another page. Fetch any item as raw Markdown by appending `.md` to its URL, or grab everything at once from https://kopimark.com/llms-full.txt._

### Start here

- [Introduction](https://kopimark.com/docs/)
- [Getting started](https://kopimark.com/docs/getting-started/)

### Concepts

- [How KopiMark works](https://kopimark.com/docs/concepts/how-kopimark-works/)
- [Figma sync and cache-only mode](https://kopimark.com/docs/concepts/figma-sync-and-cache/)
- [Roles and workspaces](https://kopimark.com/docs/concepts/roles-and-workspaces/)

### Guides

- [Connect Figma](https://kopimark.com/docs/guides/connect-figma/)
- [If your Figma seat is limited](https://kopimark.com/docs/guides/figma-seat-and-rate-limits/)
- [Invite your team](https://kopimark.com/docs/guides/invite-your-team/)
- [Translate with AI](https://kopimark.com/docs/guides/translate-with-ai/)
- [Review with comments](https://kopimark.com/docs/guides/review-with-comments/)
- [Statuses and approvals](https://kopimark.com/docs/guides/statuses-and-approvals/)
- [Custom fonts](https://kopimark.com/docs/guides/custom-fonts/)
- [Export copy](https://kopimark.com/docs/guides/export-copy/) _(this page)_
- [API and developer tokens](https://kopimark.com/docs/guides/api-and-developer-tokens/)

### Settings

- [A tour of Settings](https://kopimark.com/docs/settings/tour/)
- [Profile settings](https://kopimark.com/docs/settings/profile-settings/)
- [Workspace settings](https://kopimark.com/docs/settings/workspace-settings/)
- [Project settings](https://kopimark.com/docs/settings/project-settings/)

### Reference

- [Plans and limits](https://kopimark.com/docs/reference/plans-and-limits/)
- [Keyboard and canvas](https://kopimark.com/docs/reference/keyboard-and-canvas/)