CopyDoc supports Gemini in two ways:

• Gemini API for automated translation and import inside the plugin.
• Gemini Prompt for a manual copy and paste workflow using the Gemini app.

Use Gemini API

1. Click the Localize Text button in CopyDoc.
2. Choose Gemini API.
3. Paste your Google AI Studio API key.
4. Pick the Gemini 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 Gemini for translation and then automatically import the translated results back into Figma as cloned localized frames.

Your Gemini API key is stored per Figma user on your device and is not saved into the Figma file itself.

Use Gemini Prompt

1. Choose Gemini 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 Gemini and make sure the response contains 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 Gemini model inside Gemini yourself. CopyDoc validates the CSV structure before importing the translated frames into Figma.

The generated prompt also tells Gemini 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.

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.