---
url: "/fr/emailify/localization/locize.md"
description: "Utilisez Emailify avec l’API Locize pour envoyer le texte source depuis Figma et importer les variantes traduites depuis un namespace Locize."
---

# Traduire vos designs d’email avec Locize

> Utilisez Emailify avec l’API Locize pour envoyer le texte source depuis Figma et importer les variantes traduites depuis un namespace Locize.

## Utiliser l’API Locize avec Emailify {#use-the-locize-api-with-emailify}

Si vous utilisez [Locize](https://www.locize.com/), Emailify peut envoyer les textes source de vos designs d’email vers un namespace Locize, puis réimporter les variantes traduites dans Figma.

### Avant de commencer {#before-you-start}

Il vous faut :

- un projet Locize avec une langue de référence et au moins une langue cible ;
- une version et un namespace existants pour les traductions de vos emails ;
- une [clé API Locize](https://www.locize.com/docs/integration/api#authentication) limitée au projet.

### Étape 1 : connecter votre projet Locize {#step-1-connect-your-locize-project}

1. Cliquez sur le bouton **Localize** dans Emailify.
2. Choisissez **Locize API** dans les options de localisation.
3. Saisissez votre **Project ID** et votre **API Key**.
4. Saisissez la **Version** Locize à utiliser, par exemple `latest` ou `production`.
5. Saisissez le **Namespace** qui contient les traductions de vos emails, par exemple `emails`.
6. Choisissez l’option **Standard CDN** ou **Pro CDN** qui correspond à votre projet Locize.
7. Sous **String Key Source**, choisissez comment Emailify doit créer les clés de chaîne Locize.

Une fois connecté, Emailify affiche la langue de référence et les langues cibles configurées dans votre projet Locize.

> **Tip:** Vérifiez que le type de CDN correspond à votre projet Locize. Le Standard CDN est public et utilise un cache fixe d’une heure, tandis que le Pro CDN permet la publication privée et un cache configurable. Consultez la [comparaison des CDN de Locize](https://www.locize.com/docs/integration/cdn-types-standard-vs-pro) pour en savoir plus.

### Choisir comment les clés de chaîne Locize sont créées {#choose-how-locize-string-keys-are-created}

**Figma Node ID (Default)** conserve le comportement existant d’Emailify et utilise les ID de nœud Figma générés comme clés Locize. Les workflows Locize existants continuent d’utiliser cette option tant que vous ne la modifiez pas.

Choisissez **Figma Text Layer Name** si les noms de vos calques de texte Figma correspondent déjà aux clés de chaîne de votre namespace Locize. Emailify conserve le nom de calque complet, points compris : un calque nommé `templates.assistant_invited.h01` utilise donc exactement cette clé Locize.

Chaque calque de texte inclus doit avoir un nom, et ce nom doit être unique dans l’ensemble des emails sélectionnés. Emailify interrompt l’envoi ou l’import et signale les clés en double avant d’envoyer la moindre chaîne source à Locize. Les clés des liens et des textes alternatifs d’image reprennent le nom du calque de texte ou d’image, suivi du suffixe `_LINK` ou `_ALT_TEXT` d’Emailify. Les lignes d’objet et de texte d’aperçu (preheader) continuent d’utiliser les clés générées par Emailify, car il s’agit de métadonnées de l’email et non de calques de texte Figma.

### Étape 2 : sélectionner vos emails et les langues cibles {#step-2-select-your-emails-and-target-locales}

Choisissez les frames Emailify à localiser, puis sélectionnez les langues cibles Locize que vous importerez plus tard.

Laissez **Import Markdown Formatting** activé si le texte de votre email contient du gras, de l’italique, des liens ou des retours à la ligne que vous voulez conserver tout au long de l’aller-retour de traduction.

### Étape 3 : envoyer le texte de référence vers Locize {#step-3-upload-the-reference-copy-to-locize}

Cliquez sur **Upload** pour envoyer le texte Emailify sélectionné dans votre namespace, avec la langue de référence configurée dans Locize. Si vous modifiez plus tard le texte source dans Figma, envoyez-le de nouveau pour mettre à jour les clés Locize correspondantes.

### Étape 4 : traduire dans Locize {#step-4-translate-in-locize}

Ouvrez votre projet Locize, puis traduisez ou relisez les clés envoyées pour chaque langue cible.

### Étape 5 : importer les emails traduits dans Figma {#step-5-import-translated-emails-into-figma}

Revenez dans Emailify, sélectionnez les langues cibles souhaitées, puis cliquez sur **Import Translations**. Emailify fait correspondre les clés Locize traduites aux emails source sélectionnés et crée des copies des frames d’email pour chaque langue importée.

> **Tip:** Emailify enregistre votre clé API Locize dans le stockage client local de Figma pour votre utilisateur actuel, et non dans le fichier Figma partagé. Utilisez une clé API limitée au projet plutôt qu’un jeton d’accès personnel aux droits plus larges.