Discourse Translator

Summary: Translate posts on Discourse using Microsoft, Google, or Yandex translation APIs.

:link: GitHub: https://github.com/discourse/discourse-translator
:arrow_right: Install: Follow the plugin installation guide.


  • Each post is only translated once per locale which saves you :moneybag:
    • Note that language detection is also run once for every post. Be careful when enabling this on old and large forums.
  • Access Token is cached server side for faster translations.
  • Translations are rate limited to 3 per minute (Could be made configurable)

Translation Services Supported



  1. Follow the steps in Microsoft Translator API on Azure to obtain a subscription key. You may pick from any of the available subscription offers.

  2. Under Admin > Settings > Plugins, enter the subscription key that you’ve obtained from the steps above.

  1. Under Admin > Settings > Basic Setup, enable allow user locale.

Google Translator

  1. Go to https://console.developers.google.com

  2. Click on My project

  3. Click on the :heavy_plus_sign: to create a new project

  4. Enter your project name and click create

  5. Select Enable API and search for Google Cloud Translator API. Look for the enable button and click it to enable the API. Note that there is no free tier for the Google Translator API so it may prompt you to enable billing.

  6. Once you’re done, click on credentials in the left menu

  7. Click create credentials and select API key. Copy the API Key and paste it into the translator google api key site setting.

Known Issues

  • Does not translate text within polls generated by discourse-poll plugin.
  • Images are enlarged upon translating.



  • Allow admin to set quota and disable translation once quota has been exceeded.
  • Disable translation for private messages???


thought I’d let you know that I have DeepL working on my site using a fork by @pfaffman. Please see this post.

Is it correct you added the LibreTranslate service since last I reached out on the DeepL service? I’ll definitely have a look at that one too. I think the DeepL one performs really well but paid plans too costly for my site. I’ll see how for the 500k chracter limit takes me.

Perhaps you could look at the DeepL fork by Jay and see if you can bring it in too. Link to API documentation.

Thanks again for the great plugin!