# TranslateKit | Shortcuts Library

> Automatically localize your Shortcut

## What this shortcut does

TranslateKit localizes your shortcut automatically. Your shortcut can be understood in almost any language using TranslateKit.
Includes a built-in language picker with emoji country flags and translated language names.
TranslateKit automatically detects the system language to localize the language picker and its menus. It puts the detected system language at the top of the language picker.
How-to add to your Shortcut
Getting started with TranslateKit is as easy as 2 actions.
Run TranslateKit towards the beginning of your shortcut using a
Run Shortcut
action. Input a
Dictionary
action with
shortcut_name
, and
shortcut_id
keys. This will prompt the user to select a language to use for your shortcut. The
Run Shortcut
action will output the language they select. Keep in mind it will be in their system language.
This sets up your Shortcut with TranslateKit.
Duplicate those actions in your workflow but include a
text
key with a dictionary type value. Fill this dictionary with key value pairs.
Example:
Key
Value
MenuTitle
Example Menu
FirstMenuItem
This is the first menu item
SecondMenuItem
This is the second menu item
When run, it returns a dictionary with the same keys, but with the values translated to the language the user selected.
Refer to the full documentation for any further questions: https://translatekit.com/documentation
Dictionary Guide
Key
Type
Value
shortcut_name
(Required)
Text
Name of your Shortcut
shortcut_id
(Required)
Number
Your shortcuts ID
text
Text or Dictionary
Standard text or dictionary to translate
url
URL
JSON file URL such as ‘your_shortcut/file.json’. Method for inputting JSON from a file instead of a dictionary value.
This path is prefixed with 'iCloud Drive/Shortcuts/' by Shortcuts.
Translations are cached for quick retrieval so that if the text has not changed it won’t affect the speed of your shortcut. If it has changed, it will of course be translated again. If the input is already in the selected language, it is returned immediately.
After the first run and cache, it’s just as fast as loading your own localizations except you didn't have to translate them!
Refer to the full documentation for further details: https://translatekit.com/documentation
Badge
Here is an optional to include on your page to let your users know to download TranslateKit if they haven't already.
Just copy-paste the markdown below:
[![Requires TranslateKit](https://i.imgur.com/H8RJgxY.png)](
Offline
TranslateKit requires a stable internet connection to translate or get cached translations from iCloud. Translation speed or loading the cache can be slow as a result of a poor connection. The original text is returned immediately when offline.
Localization
TranslateKit detects the system language automatically to translate its internal menus, dialogues, and the names for languages. It does
not
use Mail, Calendars or Location Services to detect your system language.
Compatibility
TranslateKit uses the default translation actions to detect languages and translate text and dictionaries. This of course means that it is limited by what the actions support.
Dependencies:
UpdateKit
Versions after 2.1.3 are not created using ScPL.

## Compatibility

iPhone, iPad

## Required apps

Files

[View this page](https://shortcutlibrary.app/shortcuts/translatekit)

[Download Shortcuts Library on the App Store](https://apps.apple.com/app/id6759494377)