ComfyUI-Text-Translation Introduction
ComfyUI-Text-Translation adds text translation and text-handling nodes to ComfyUI. You can write a prompt in one language, translate it, and pass the resulting text to another node in your workflow. The standard translation node automatically detects the input language and translates it into English using Bing by default.
The extension also helps you assemble prompts from separate pieces of text. You can combine text inputs, keep reusable text in a dedicated node, or switch a piece of text off without removing it from your workflow.
The current version uses the Translators library to access multiple translation services. You do not need to apply for a translation API key to use this version.
Important for older workflows: The project was previously named
ComfyUI_Text_Translation_zh_CNand was renamedComfyUI_Text_Translation. Projects using versions from before May 19, 2024 are not compatible with the rewritten version. Remove the old project before updating.
How ComfyUI-Text-Translation Works
Think of the translation node as an interpreter between your written prompt and the next node in your ComfyUI workflow:
- You provide text, such as a scene description or a prompt fragment.
- The translation node sends that text through a translation service made available by the Translators library.
- The node outputs translated text that you can connect to another text input. For example, you might write a scene description in your preferred language, translate it into English, and use that output as part of an image-generation prompt. If you want to build a prompt from several parts, the Text Concatenate node can join them into one string before you pass it onward.
Translation services do not necessarily support the same languages or language pairs. If you choose a service and language in the full V2 node, check whether that combination is supported before relying on it in a workflow. The Translators documentation is the reference linked by the author for provider information.
ComfyUI-Text-Translation Features
Text Translation
<img src="images/Text_Translation.png" width="512" alt="Text Translation node" />
This is the straightforward option when you want to translate text without choosing a service or language settings each time. By default, it uses Bing, detects the source language automatically, and translates the text into English.
Text Translation V2
<img src="images/Text_Translation_V2.png" width="1024" alt="Text Translation V2 node" />
V2 offers a selection of translation services and languages. It includes only some of the options available in the full version, making it easier to navigate when you do not need the entire list.
Extra options are hidden by default. Click Show / Hide button to reveal or conceal them.
Text Translation V2 (Full Version)
<img src="images/Text_Translation_V2_Full.png" width="1024" alt="Full Text Translation V2 node" />
The full V2 node exposes the extension’s complete lists of translation services and languages. Use it when the regular V2 node does not show the option you need. Its extra options are also hidden by default; click Show / Hide button to see them.
A listed option is not a guarantee that every service supports every language. Test your chosen combination, and consult Translators if a translation fails.
Text Concatenate
<img src="images/Text_Concatenate.png" width="200" alt="Text Concatenate node" />
<img src="images/Text_Concatenate2.png" width="700" alt="Text Concatenate node with multiple connections" />
Text Concatenate joins its inputs into one string. It automatically adds or removes input ports according to the number of connections. This is useful when you keep parts of a prompt separate, such as a subject description and a style description, but need to send them onward as one piece of text.
Text
<img src="images/Text.png" width="512" alt="Text input node" />
The Text node provides a text box for entering text directly into your workflow. You can use it for a prompt, a phrase to translate, or a reusable piece of wording.
Text Switch
<img src="images/Text_Switch.png" width="256" alt="Text Switch node" />
The Text Switch controls whether text passes through. When it is off, it outputs an empty string. This lets you temporarily leave a text segment out of a workflow without deleting it.
Showing the Output Text
If you want to see a node’s text output in ComfyUI, the author suggests using a display node such as ShowText from ComfyUI-Custom-Scripts. This can help you inspect a translation before using it elsewhere in your workflow.
ComfyUI-Text-Translation Services and Languages
The extension lists the following translation services. These are service choices, not separate AI models; the provided documentation does not describe any models to download or select.
| Service | Service | Service |
| --- | --- | --- |
| Alibaba (alibaba) | Apertium (apertium) | Argos (argos) |
| Baidu (baidu) | Bing (bing) | Caiyun (caiyun) |
| CloudTranslation (cloudTranslation) | DeepL (deepl) | Elia (elia) |
| Google (google) | Hujiang (hujiang) | ICIBA (iciba) |
| iFlytek (iflytek) | iFlyrec (iflyrec) | iTranslate (itranslate) |
| Judic (judic) | LanguageWire (languageWire) | Lingvanex (lingvanex) |
| Niutrans (niutrans) | Mglip (mglip) | Mirai (mirai) |
| ModernMT (modernMt) | MyMemory (myMemory) | Papago (papago) |
| QQFanyi (qqFanyi) | QQTranSmart (qqTranSmart) | Reverso (reverso) |
| Sogou (sogou) | Systran (sysTran) | Tilde (tilde) |
| Translate.com (translateCom) | TranslateMe (translateMe) | UTibet (utibet) |
| VolcEngine (volcEngine) | Yandex (yandex) | Yeekit (yeekit) |
| Youdao (youdao) | | |
The original README lists these language options. Codes are shown as listed there; check the selected service’s support for your intended language pair.
| Language | Code | Language | Code |
| --- | --- | --- | --- |
| Chinese | zh | English | en |
| Arabic | ar | Russian | ru |
| French | fr | German | de |
| Spanish | es | Portuguese | pt |
| Italian | it | Japanese | ja |
| Korean | ko | Greek | el |
| Dutch | nl | Hindi | hi |
| Turkish | tr | Malay | ms |
| Thai | th | Vietnamese | vi |
| Indonesian | id | Hebrew | he |
| Polish | pl | Mongolian | mn |
| Czech | cs | Hungarian | hu |
| Estonian | et | Bulgarian | bg |
| Danish | da | Finnish | fi |
| Romanian | ro | Swedish | sv |
| Slovenian | sl | Persian | fa |
| Bosnian | bs | Serbian | sr |
| Fijian | fj | Tagalog | tl |
| Haitian Creole | ht | Catalan | ca |
| Classical Chinese | wyw | Cantonese | yue |
| Inner Mongolian | mn | Uyghur | uy |
| Tibetan | ti | White Hmong | mww |
| Yi | ii | Hmong | hmn |
| Zhuang | zyb | | |
What's New with ComfyUI-Text-Translation
- May 25, 2025: Fixed an issue with Text Concatenate connections when refreshing ComfyUI or copying and pasting the node in the then-current version of ComfyUI. The author credits MakkiShizu for the proposed fix.
- May 20, 2024: Added languages to Text Translation V2 and introduced Text Translation V2 (Full Version). The Get Translation Platform List node was removed.
- May 19, 2024: Replaced the previous Tencent Translation API approach with the Translators library, removing the need to apply for an API key. The author also rewrote the nodes and added or revised Text Translation, Text Translation V2, Get Translation Platform List, Text, Text Switch, and Text Concatenate. The platform-list node was removed in the following update.
- August 27, 2023: Removed the default value from the translation switch to address a compatibility issue with StableSwarmUI.
- August 22, 2023: Initial release, using the Tencent Translation API (https://cloud.tencent.com/product/tmt).
Troubleshooting ComfyUI-Text-Translation
A V2 Node Reports “Value not in list”
You may see an error resembling:
text Prompt outputs failed validation Text_Translation_V2:
- Value not in list: translator: 'alibaba' not in ['Bing', 'Google', 'Alibaba']
The author’s recommended fix is to delete the affected node from the workflow and add it again. Then select the translation option you want in the newly added node and try the workflow again.
A Service Does Not Translate the Selected Language
- Check which service and languages you selected in the V2 or full V2 node.
- Consult the service information linked from Translators.
- Test a supported combination, or select another available service. The full node displays all listed choices, but the documentation cautions that a particular service may not support your selected language.
Frequently Asked Questions
Do I need a translation API key? No. The current version described by the author uses the Translators library without requiring you to apply for one.
Which translation node should I start with? Start with Text Translation if automatic language detection, Bing, and English output meet your needs. Use Text Translation V2 for its additional choices, or the full V2 node when you need to browse the complete lists.
Why can’t I see all the V2 settings? Extra options are hidden by default. Click Show / Hide button on the node.
How can I check what a translation produced?
Connect the output to a text-display node. The author specifically mentions ShowText from ComfyUI-Custom-Scripts.
Can I keep a prompt fragment in my workflow without using it every time? Yes. The Text Switch outputs an empty string when off, so you can turn that text off without deleting the node.
Will a workflow from before May 19, 2024 work with the rewritten extension? The author states that the old project is completely incompatible with the rewritten one. Remove the old project before updating, and expect to replace its old nodes in your workflow.
Learn More about ComfyUI-Text-Translation
- ComfyUI: Learn about the node-based application in which this extension runs.
- Translators: Check information about the translation library and its services when choosing a provider or language pair.
- ComfyUI-Custom-Scripts: Explore
ShowTextif you need to display translated text in your workflow.
