--- description: Unofficial Capacitor plugin for Google ML Kit Translation SDK to translate text between languages with support for Android and iOS. title: Capacitor ML Kit Translation Plugin for Android & iOS - Capawesome image: https://capawesome.io/docs/assets/images/social/plugins/mlkit/translation.png --- [ Skip to content](#capacitor-mlkittranslation) [ 🎉 Introducing **Capawesome Platform** — one platform for Live Updates, Native Builds, App Store Publishing, and Insider SDKs.](https://capawesome.io) * [ Formbricks ](/docs/plugins/formbricks/) * [ Geocoder ](/docs/plugins/geocoder/) * [ Google Sign-In ](/docs/plugins/google-sign-in/) * [ libSQL ](/docs/plugins/libsql/) * [ Live Update ](/docs/plugins/live-update/) * [ Managed Configurations ](/docs/plugins/managed-configurations/) * [ Media Session ](/docs/plugins/media-session/) * [ ML Kit ](/docs/plugins/mlkit/) * [ iOS ](#ios) * [ Configuration ](#configuration) * [ Demo ](#demo) * [ Usage ](#usage) * [ API ](#api) * [ Enums ](#enums) * [ Terms & Privacy ](#terms-privacy) * [ Changelog ](#changelog) * [ License ](#license) * [ NFC ](/docs/plugins/nfc/) * [ OAuth ](/docs/plugins/oauth/) * [ Pedometer ](/docs/plugins/pedometer/) * [ Photo Editor ](/docs/plugins/photo-editor/) * [ PostHog ](/docs/plugins/posthog/) * [ Printer ](/docs/plugins/printer/) * [ Purchases ](/docs/plugins/purchases/) * [ RealtimeKit ](/docs/plugins/realtimekit/) * [ Screen Orientation ](/docs/plugins/screen-orientation/) * [ Screenshot ](/docs/plugins/screenshot/) * [ Secure Preferences ](/docs/plugins/secure-preferences/) * [ Speech Recognition ](/docs/plugins/speech-recognition/) * [ Speech Synthesis ](/docs/plugins/speech-synthesis/) * [ Share Target ](/docs/plugins/share-target/) * [ Square Mobile Payments ](/docs/plugins/square-mobile-payments/) * [ SQLite ](/docs/plugins/sqlite/) * [ Superwall ](/docs/plugins/superwall/) * [ Torch ](/docs/plugins/torch/) * [ Wifi ](/docs/plugins/wifi/) * [ Zip ](/docs/plugins/zip/) * [ Cloud ](/docs/cloud/) * [ Live Updates ](/docs/cloud/live-updates/) * Advanced * Integrations * [ Native Builds ](/docs/cloud/native-builds/) * [ Configuration ](/docs/cloud/native-builds/configuration/) * [ Environments ](/docs/cloud/native-builds/environments/) * Guides * [ Sample Projects ](/docs/cloud/native-builds/sample-projects/) * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ Automations ](/docs/cloud/automations/) * [ Assist ](/docs/cloud/assist/) * Account * Organizations * [ Organization and User Management ](/docs/cloud/organizations/memberships/) * [ Single Sign-On (SSO) ](/docs/cloud/organizations/sso/) * [ Teams ](/docs/cloud/organizations/teams/) * [ Two-Factor Authentication ](/docs/cloud/organizations/two-factor-authentication/) * [ Integrations ](/docs/cloud/integrations/) * [ License Keys ](/docs/cloud/license-keys/) * [ Webhooks ](/docs/cloud/webhooks/) * [ Pricing ](https://capawesome.io/pricing/) * [ FAQ ](/docs/cloud/faq/) * [ Support ](/docs/cloud/support/) * [ Contributing ](/docs/contributing/) * [ LLMs ](/docs/llms/) * [ Insiders ](/docs/insiders/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/insiders/support/) * [ FAQ ](/docs/insiders/faq/) * [ Blog ](/blog/) * Categories * [ iOS ](#ios) * [ Configuration ](#configuration) * [ Demo ](#demo) * [ Usage ](#usage) * [ API ](#api) * [ Enums ](#enums) * [ Terms & Privacy ](#terms-privacy) * [ Changelog ](#changelog) * [ License ](#license) # @capacitor-mlkit/translation[¶](#capacitor-mlkittranslation "Permanent link") Unofficial Capacitor plugin for [ML Kit Translation](https://developers.google.com/ml-kit/language/translation).[1](#fn:1) [ ![Deliver Live Updates to your Capacitor app with Capawesome Cloud](../../../assets/external/cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.69628c3f.png) ](https://cloud.capawesome.io/) ## Newsletter[¶](#newsletter "Permanent link") Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/). ## Compatibility[¶](#compatibility "Permanent link") | Plugin Version | Capacitor Version | Status | | -------------- | ----------------- | -------------- | | 8.x.x | \>=8.x.x | Active support | | 7.x.x | 7.x.x | Deprecated | | 6.x.x | 6.x.x | Deprecated | | 5.x.x | 5.x.x | Deprecated | ## Installation[¶](#installation "Permanent link") You can use our **AI-Assisted Setup** to install the plugin. Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command: `[](#%5F%5Fcodelineno-0-1)npx skills add capawesome-team/skills --skill capacitor-plugins ` Then use the following prompt: `` [](#%5F%5Fcodelineno-1-1)Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capacitor-mlkit/translation` plugin in my project. `` If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below: `[](#%5F%5Fcodelineno-2-1)npm install @capacitor-mlkit/translation [](#%5F%5Fcodelineno-2-2)npx cap sync ` **Attention**: This plugin **only supports CocoaPods** for iOS dependency management. Swift Package Manager (SPM) is not supported for the ML Kit SDK, see [this comment](https://github.com/googlesamples/mlkit/issues/180#issuecomment-1298964099). ### Android[¶](#android "Permanent link") #### Variables[¶](#variables "Permanent link") If needed, you can define the following project variable in your app’s `variables.gradle` file to change the default version of the dependency: * `$mlkitTranslateVersion` version of `com.google.mlkit:translate` (default: `17.0.3`) This can be useful if you encounter dependency conflicts with other plugins in your project. ### iOS[¶](#ios "Permanent link") #### Minimum Deployment Target[¶](#minimum-deployment-target "Permanent link") Make sure to set the deployment target in your `ios/App/Podfile` to at least `15.5`: `[](#%5F%5Fcodelineno-3-1)platform :ios, '15.5' ` ## Configuration[¶](#configuration "Permanent link") No configuration required for this plugin. ## Demo[¶](#demo "Permanent link") A working example can be found here: [robingenz/capacitor-mlkit-plugin-demo](https://github.com/robingenz/capacitor-mlkit-plugin-demo) ## Usage[¶](#usage "Permanent link") `[](#%5F%5Fcodelineno-4-1)import { Translation, Language } from '@capacitor-mlkit/translation'; [](#%5F%5Fcodelineno-4-2) [](#%5F%5Fcodelineno-4-3)const deleteDownloadedModel = async () => { [](#%5F%5Fcodelineno-4-4) await Translation.deleteDownloadedModel({ [](#%5F%5Fcodelineno-4-5) language: Language.English, [](#%5F%5Fcodelineno-4-6) }); [](#%5F%5Fcodelineno-4-7)}; [](#%5F%5Fcodelineno-4-8) [](#%5F%5Fcodelineno-4-9)const downloadModel = async () => { [](#%5F%5Fcodelineno-4-10) await Translation.downloadModel({ [](#%5F%5Fcodelineno-4-11) language: Language.English, [](#%5F%5Fcodelineno-4-12) }); [](#%5F%5Fcodelineno-4-13)}; [](#%5F%5Fcodelineno-4-14) [](#%5F%5Fcodelineno-4-15)const getDownloadedModels = async () => { [](#%5F%5Fcodelineno-4-16) const { languages } = await Translation.getDownloadedModels(); [](#%5F%5Fcodelineno-4-17) return languages; [](#%5F%5Fcodelineno-4-18)}; [](#%5F%5Fcodelineno-4-19) [](#%5F%5Fcodelineno-4-20)const translate = async () => { [](#%5F%5Fcodelineno-4-21) const { text } = await Translation.translate({ [](#%5F%5Fcodelineno-4-22) text: 'Good morning!', [](#%5F%5Fcodelineno-4-23) sourceLanguage: Language.English, [](#%5F%5Fcodelineno-4-24) targetLanguage: Language.German, [](#%5F%5Fcodelineno-4-25) }); [](#%5F%5Fcodelineno-4-26) return text; [](#%5F%5Fcodelineno-4-27)}; ` ## API[¶](#api "Permanent link") * [deleteDownloadedModel(...)](#deletedownloadedmodel) * [downloadModel(...)](#downloadmodel) * [getDownloadedModels()](#getdownloadedmodels) * [translate(...)](#translate) * [Interfaces](#interfaces) * [Enums](#enums) ### deleteDownloadedModel(...)[¶](#deletedownloadedmodel "Permanent link") `[](#%5F%5Fcodelineno-5-1)deleteDownloadedModel(options: DeleteDownloadedModelOptions) => Promise ` Delete the language model for the given language. Only available on Android and iOS. | Param | Type | | ----------- | ------------------------------------------------------------- | | **options** | [DeleteDownloadedModelOptions](#deletedownloadedmodeloptions) | **Since:** 0.0.1 --- ### downloadModel(...)[¶](#downloadmodel "Permanent link") `[](#%5F%5Fcodelineno-6-1)downloadModel(options: DownloadModel) => Promise ` Download a language model for offline translation. Language models are around 30MB in size, so be sure to only download the models you need and only download them using a WiFi connection unless the user has specified otherwise. Only available on Android and iOS. | Param | Type | | ----------- | ------------------------------- | | **options** | [DownloadModel](#downloadmodel) | **Since:** 0.0.1 --- ### getDownloadedModels()[¶](#getdownloadedmodels "Permanent link") `[](#%5F%5Fcodelineno-7-1)getDownloadedModels() => Promise ` Get the languages for which a model has been downloaded. Only available on Android and iOS. **Returns:** `Promise<[GetDownloadedModelsResult](#getdownloadedmodelsresult)>` **Since:** 0.0.1 --- ### translate(...)[¶](#translate "Permanent link") `[](#%5F%5Fcodelineno-8-1)translate(options: TranslateOptions) => Promise ` Translate the given text. If the language model for the given source and target languages is not downloaded, it will be downloaded automatically which may take some time. If you want to avoid this, use the `downloadModel(...)` method to download the model first. Only available on Android and iOS. | Param | Type | | ----------- | ------------------------------------- | | **options** | [TranslateOptions](#translateoptions) | **Returns:** `Promise<[TranslateResult](#translateresult)>` **Since:** 0.0.1 --- ### Interfaces[¶](#interfaces "Permanent link") #### DeleteDownloadedModelOptions[¶](#deletedownloadedmodeloptions "Permanent link") | Prop | Type | Description | Since | | ------------ | --------------------- | ------------------------------------------- | ----- | | **language** | [Language](#language) | The language for which to delete the model. | 0.0.1 | #### DownloadModel[¶](#downloadmodel%5F1 "Permanent link") | Prop | Type | Description | Since | | ------------ | --------------------- | --------------------------------------- | ----- | | **language** | [Language](#language) | The language to download the model for. | 0.0.1 | #### GetDownloadedModelsResult[¶](#getdownloadedmodelsresult "Permanent link") | Prop | Type | Description | | ------------- | ------------ | ---------------------------------------------------- | | **languages** | Language\[\] | The languages for which a model has been downloaded. | #### TranslateResult[¶](#translateresult "Permanent link") | Prop | Type | Description | Since | | -------- | ------ | -------------------- | ----- | | **text** | string | The translated text. | 0.0.1 | #### TranslateOptions[¶](#translateoptions "Permanent link") | Prop | Type | Description | Since | | | ------------------ | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ----- | | **text** | string | The text to translate. | 0.0.1 | | | **sourceLanguage** | [Language](#language) | The source language of the text. If you don't know the source language, you can use the [Language Identification plugin to detect it. 0.0.1 **targetLanguage** ](#language)[Language](#language) | The target language to translate the text to. | 0.0.1 | ### Enums[¶](#enums "Permanent link") #### Language[¶](#language "Permanent link") | Members | Value | Since | | -------------- | ----- | ----- | | **Afrikaans** | 'af' | 0.0.1 | | **Arabic** | 'ar' | 0.0.1 | | **Belarusian** | 'be' | 0.0.1 | | **Bulgarian** | 'bg' | 0.0.1 | | **Bengali** | 'bn' | 0.0.1 | | **Catalan** | 'ca' | 0.0.1 | | **Czech** | 'cs' | 0.0.1 | | **Welsh** | 'cy' | 0.0.1 | | **Danish** | 'da' | 0.0.1 | | **German** | 'de' | 0.0.1 | | **Greek** | 'el' | 0.0.1 | | **English** | 'en' | 0.0.1 | | **Esperanto** | 'eo' | 0.0.1 | | **Spanish** | 'es' | 0.0.1 | | **Estonian** | 'et' | 0.0.1 | | **Persian** | 'fa' | 0.0.1 | | **Finnish** | 'fi' | 0.0.1 | | **French** | 'fr' | 0.0.1 | | **Irish** | 'ga' | 0.0.1 | | **Galician** | 'gl' | 0.0.1 | | **Gujarati** | 'gu' | 0.0.1 | | **Hebrew** | 'he' | 0.0.1 | | **Hindi** | 'hi' | 0.0.1 | | **Croatian** | 'hr' | 0.0.1 | | **Haitian** | 'ht' | 0.0.1 | | **Hungarian** | 'hu' | 0.0.1 | | **Indonesian** | 'id' | 0.0.1 | | **Icelandic** | 'is' | 0.0.1 | | **Italian** | 'it' | 0.0.1 | | **Japanese** | 'ja' | 0.0.1 | | **Georgian** | 'ka' | 0.0.1 | | **Kannada** | 'kn' | 0.0.1 | | **Korean** | 'ko' | 0.0.1 | | **Lithuanian** | 'lt' | 0.0.1 | | **Latvian** | 'lv' | 0.0.1 | | **Macedonian** | 'mk' | 0.0.1 | | **Marathi** | 'mr' | 0.0.1 | | **Malay** | 'ms' | 0.0.1 | | **Maltese** | 'mt' | 0.0.1 | | **Dutch** | 'nl' | 0.0.1 | | **Norwegian** | 'no' | 0.0.1 | | **Polish** | 'pl' | 0.0.1 | | **Portuguese** | 'pt' | 0.0.1 | | **Romanian** | 'ro' | 0.0.1 | | **Russian** | 'ru' | 0.0.1 | | **Slovak** | 'sk' | 0.0.1 | | **Slovenian** | 'sl' | 0.0.1 | | **Albanian** | 'sq' | 0.0.1 | | **Swedish** | 'sv' | 0.0.1 | | **Swahili** | 'sw' | 0.0.1 | | **Tamil** | 'ta' | 0.0.1 | | **Telugu** | 'te' | 0.0.1 | | **Thai** | 'th' | 0.0.1 | | **Tagalog** | 'tl' | 0.0.1 | | **Turkish** | 'tr' | 0.0.1 | | **Ukrainian** | 'uk' | 0.0.1 | | **Urdu** | 'ur' | 0.0.1 | | **Vietnamese** | 'vi' | 0.0.1 | | **Chinese** | 'zh' | 0.0.1 | ## Terms & Privacy[¶](#terms-privacy "Permanent link") This plugin uses the [Google ML Kit](https://developers.google.com/ml-kit): * [Terms & Privacy](https://developers.google.com/ml-kit/terms) * [Android Data Disclosure](https://developers.google.com/ml-kit/android-data-disclosure) * [iOS Data Disclosure](https://developers.google.com/ml-kit/ios-data-disclosure) ## Changelog[¶](#changelog "Permanent link") See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-mlkit/blob/main/packages/translation/CHANGELOG.md). ## License[¶](#license "Permanent link") See [LICENSE](https://github.com/capawesome-team/capacitor-mlkit/blob/main/packages/translation/LICENSE). --- 1. This project is not affiliated with, endorsed by, sponsored by, or approved by Google LLC or any of their affiliates or subsidiaries. [↩](#fnref:1 "Jump back to footnote 1 in the text") May 17, 2026 Back to top