<< Back

How to Translate Foreign Language Text with Alteryx

It’s relatively easy to translate text nowadays, with Google Translate just a few clicks and a copy and paste away, deciphering information from a language you have no skill in whatsoever has never been easier. But what if you needed to translate thousands of pieces of information within a dataset?

Well, one of our clients recently wished to do just this with one of their biggest surveys. Over 20,000 respondents from multiple countries around the world gave satisfaction scores on various performance areas relating to the business. They were also invited to leave a free text comment, which resulted in a large and rich data source for identifying problem areas. The problem is, these results were very localised and comments were left in more than 15 different languages. Copy and paste will no longer cut it.

Thankfully there are ways to access the technology that supports online translation services. APIs are available that handle the translation work, they just need to be adapted for complete ease of use within Alteryx. In solving this problem for the client, I created a macro that uses a Microsoft translation API that anyone can use following a few simple steps.

Solution: The Translator Macro

Here is the finished product, a macro that handles all the underlying API magic (sending data, getting authentication, tidying up the results) and requires minimal input from a user perspective to get a single field translated into a language of the user’s choosing.



Get the macro

You’ll need to download and save the macro from the Alteryx public gallery here (this will download a yxi file, which means Alteryx will install everything needed to use the macro).


  1. Simply enter your API Key (more on this below)
  2. Choose the text field you need to be translated
  3. Choose the language you need everything to be translated into

The Results

Once you’ve hit run and received that lovely ‘ding’ that tells you the workflow is complete, you’ll be able to see your original text, the translated text, and the language of your original text. Beautiful.

Now the text is translated you can start looking at doing other interesting things like getting sentiment analysis, or searching for the key themes/topics using the Cognitive Services Text Analytics tool.


Obtaining an API Key

Unfortunately, there is a little bit of groundwork required to get your API key, but this is nothing more than filling out a few forms to activate a Microsoft Azure account, and activating the specific Azure translation service you will use (via the Alteryx macro).

Follow the instructions at this Alteryx community blog post but, crucially, when choosing the API type, choose Translator Text API (not the Text Analytics API – this is for sentiment analysis).


Microsoft has a free usage limit of 2 million characters per month, you can’t spend any money without explicitly selecting a paid tier of usage, but beware each time you run a workflow you will be using up your free credit, so it’s best to save the results on your first run to avoid rinsing through your allowance.

For more information on the use of the API see the following links.




If you notice any bugs or have any feedback on this macro, please get in touch! Happy translating.



6 thoughts on “How to Translate Foreign Language Text with Alteryx

  1. Hi Peter, Wondering if I could pick your brains regarding an error thats coming up when I try to run this macro, When I run it its coming up with the following error;

    Error: Cognitive Services Text Translation (2): Tool #34: Iteration #2: Tool #31: The field schema for the output “translation” changed between iterations.



  2. Thanks for sharing this tool, Peter!
    I have tried this in the newest alteryx designer 2018.4. However an error message pops up saying “an unknown error occurred in ii_pushrecord” which seems to within the AUTHENTICATION phase of the “Translate_API_Call” macro. I have no idea about what is happening. Do you have similar issues?

  3. The concept is great but it seems like the cognitive service text translation is no longer available in the gallery, only the text analytics, which provide sentiment, key phrase extraction and language detection only but no translation 🙁

  4. I wrote initially that it didn’t work, but it was because the API call was made to a specific region and my translate resource was in the East US. After changing that, it ran smooth. Thank you Peter.

Leave a Reply

Your email address will not be published. Required fields are marked *