---
url: "/copydoc/localization/chatgpt.md"
description: "Use ChatGPT inside CopyDoc with either direct API translation or manual CSV prompts to localize your selected Figma frames in Figma."
---

# Translating your Figma frames with ChatGPT

> Use ChatGPT inside CopyDoc with either direct API translation or manual CSV prompts to localize your selected Figma frames in Figma.

CopyDoc supports ChatGPT in two ways:

- **ChatGPT API** for automated translation and import inside the plugin.
- **ChatGPT Prompt** for a manual copy and paste workflow using the ChatGPT app.

## Use ChatGPT API

The API workflow is the fastest option if you want CopyDoc to handle the full translation and import flow for you.

1. Click the **Localize Text** button in CopyDoc.
2. Choose **ChatGPT API**.
3. Paste your OpenAI [API key](https://platform.openai.com/api-keys).
4. Pick the model you want CopyDoc to use.
5. Select the Figma frames and target locales you want to translate.
6. Enable **Use Markdown** if you need to preserve inline bold, italic, and linked text during translation.
7. Click **Translate & Import**.

CopyDoc will send the selected frame text to ChatGPT for each locale, then automatically import the translated results back into Figma as cloned localized frames.

> **Tip:** Your ChatGPT API key is stored per Figma user on your device and is not saved into the Figma file itself.

## Use ChatGPT Prompt

The manual prompt workflow is useful if you prefer to run translation requests yourself inside ChatGPT instead of connecting an API key.

1. Choose **ChatGPT Prompt** in the localization options.
2. Select the Figma frames and locales you want to translate.
3. Click **Generate Prompt**.
4. Click **Copy Prompt to Clipboard**.
5. Run the prompt in ChatGPT and make sure it returns **raw CSV only**.
6. Paste the CSV response back into CopyDoc.
7. Click **Translate Figma Frames** to import the translated content into Figma.

In the manual prompt workflow, you choose the ChatGPT model inside the ChatGPT app yourself. CopyDoc validates the pasted CSV before importing it.

The generated prompt also tells ChatGPT to preserve supported inline markdown formatting and keep markdown markers, URLs, and placeholders unchanged so the translated content can be imported back into Figma correctly.

> **Tip:** Do not remove or rename the `id`, `frame_id`, `layer_name`, or `figma_text` columns in the CSV response. CopyDoc uses those columns to match translated rows back to the correct Figma layers.