{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":39712,"path":"platform-administration/system-localization/translating-applications.md","title":"Translating custom content","bundle":null,"doc_type":null,"release":"australia","body":"\n# Translating custom content\n\nTranslate content you create or modify to a supported language or add an unsupported language.\n\n**Note:** Using the Localization Framework application is recommend for translating to an unsupported language or translating large amounts of custom UI string content in a supported language. For more information, see [Localization Framework](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/localization-framework/localization-framework-landing.md).\n\nServiceNow provides translations of the base system UI strings in supported languages through the internationalization \\(I18N\\) language plugins. For applications you create and modifications you make to the ServiceNow AI Platform® content, you must provide your own translations. You can also provide any translations to unsupported languages that ServiceNow does not provide translations for. The ServiceNow AI Platform does not provide any automatic translation capability.\n\nThe translation method depends on the material that you are translating. Repeat the translation process whenever you edit or update content.\n\n<table id=\"table_xfh_rgr_f3b\"><thead><tr><th>\n\nWhat needs translation\n\n</th><th>\n\nApproach to take\n\n</th><th>\n\nResources\n\n</th></tr></thead><tbody><tr><td>\n\nField labels in a table for a customer-created application\n\n</td><td>\n\n1.  Create English versions for all fields in the table.\n2.  Locate the records for the table in the application.\n3.  Open the Field Labels translation table.\n4.  Export the records, translate the appropriate fields, set the language field, and reimport through an import set.\n\n</td><td>\n\n-   [Export and edit translation records](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/system-localization/t_TranslateTheInterface.md)\n-   Alternatively, follow the procedure for translating individual labels in [Translate a field label](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/system-localization/t_TranslateAFieldLabel.md).\n\n</td></tr><tr><td>\n\nHTML in a UI page in a customer-created application\n\n</td><td>\n\n1.  Create the English version. When creating the HTML in the UI Page form, wrap any translatable text in `gs.getMessage` calls.\n2.  Create a Message \\[sys\\_ui\\_message\\] record for each English message with a corresponding key/value pair.\n3.  Create additional Message records for each message for each other language.\n\n</td><td>\n\n[Translate a client script message](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/system-localization/t_TranslateAClientScriptMessage.md)\n\n</td></tr><tr><td>\n\nService Catalog items\n\n</td><td>\n\n1.  Navigate to **All** &gt; **System Properties** &gt; **System Localization** and set **Display translation prefix on translatable strings** to **Yes**.\n2.  Create the item in English.\n3.  Change the preferred language to a different language.\n4.  Translate all the translatable items, now identified by translation prefix.\n5.  Save the record.\n\n</td><td>\n\n-   To activate translation prefixes, see [Debug translations](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/system-localization/t_DisplayATranslationPrefix.md).\n-   For translatable text fields, which are common in Service Catalog items, see [Translating text fields](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/system-localization/c_UseTranslatedText.md).\n\n</td></tr><tr><td>\n\nService Portal widget\n\n</td><td>\n\n1.  Create the English version. Externalize any translatable text by surrounding the text with`${}` wrappers.\n2.  Create a Message \\[sys\\_ui\\_message\\] record for each English translatable text with a corresponding key/value pair.\n3.  Create additional Message records for each piece of translatable text for each other language.\n\n</td><td>\n\n-   [Translate a client script message](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/system-localization/t_TranslateAClientScriptMessage.md)\n-   [Internationalize a widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-user-interface/c_WidgetLocalization.md) in Service Portal documentation\n-   For unofficial advice, see [Building multi-lingual service portals](https://www.dylanlindgren.com/2018/11/07/building-multilingual-service-portals/)\n\n</td></tr><tr><td>\n\nPlaybooks\n\n</td><td>\n\n1.  Activate any playbook that you want to translate.\n2.  Create translations for each translatable text in a playbook's process definition \\[sys\\_pd\\_process\\_definition\\].\n\n</td><td>\n\n[Add translations for Playbooks](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/build-workflows/add-translations-playbooks.md)\n\n</td></tr><tr><td>\n\nEdit a translation provided in a plugin\n\n</td><td>\n\n1.  Export the records from the translation table.\n2.  Edit them outside the translation table and reimport them.\n\n Do not edit the records directly, because your changes could be overwritten when you upgrade or zBoot your instance.\n\n</td><td>\n\n[Export and edit translation records](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/system-localization/t_TranslateTheInterface.md)\n\n</td></tr><tr><td>\n\nTranslate an instance to an unsupported language\n\n</td><td>\n\n1.  Create a Choice \\[sys\\_choice\\] record for that language.\n2.  Add other translation records through the Export and import set approach.\n\n</td><td>\n\n[Translating to an unsupported language](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/system-localization/self-localize.md)\n\n</td></tr><tr><td>\n\nSupport Chat texts\n\n</td><td>\n\nSupport Chat is mostly translated through the I18N language plugins. If you customize any Support Chat texts, follow the procedure for Service Portal widgets.\n\n</td><td>\n\n[Internationalize a widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-user-interface/c_WidgetLocalization.md) in Service Portal documentation\n\n</td></tr><tr><td>\n\nNotifications and surveys\n\n</td><td>\n\nSystem Localization does not cover platform notifications or surveys. The usual approach is to create a separate version of each survey or notification in each language and use business rules to send the right language version to the right end user.\n\n</td><td>\n\n—\n\n</td></tr></tbody>\n</table>-   **[Export and edit translation records](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/system-localization/t_TranslateTheInterface.md)**  \nExport translation records to translate to additional languages in your preferred translation environment and import the new or edited translation records through import sets.\n\n**Parent Topic:**[System Localization](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/system-localization/system-localization-landing.md)\n\n"}}