{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"AITRANSLATE Function","siteUrl":"https://developers.smartsheet.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"aitranslate-function","__idx":0},"children":["AITRANSLATE Function"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The AITRANSLATE function translates text from one or more cells into a specified language. The AI does the translation. The function does not write the cell value during the calculation. The function collects its parameters and sends an AI event. The system writes the translation in the cell when it completes the event."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AITRANSLATE is a SmartColumn AI function. Use it only as a column formula. Do not use it in a different function. Do not use it in a cell formula."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"syntax","__idx":1},"children":["Syntax"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"AITRANSLATE(data, language, [additional_instructions])\n"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["data"]}," The text to translate. Use a cell reference, a range, or a LIST() of values. Use LIST() to put values from more than one column into one input."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["language"]}," The code of the target language. Examples: \"es\", \"fr\", \"de\"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["additional_instructions"]}," (optional) Text instructions for the AI. Examples: the level of formality, special terms, or a style."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sample-usage","__idx":2},"children":["Sample usage"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"AITRANSLATE([Customer Feedback]@row, \"es\", \"Use formal language\")\n"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"AITRANSLATE(LIST([Subject]@row, [Body]@row), \"fr\")\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"examples","__idx":3},"children":["Examples"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The AITRANSLATE function makes a translation for each row. Teams that speak different languages can then use the same sheet."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The input can come from one column. It can also come from more than one column with LIST()."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the target language with a language code. Examples: \"es\", \"fr\", \"de\"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The optional instructions control the formality or the special terms."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The system writes the values after it completes the AI event. The cell can be empty for a short time after you set the formula."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example","__idx":4},"children":["Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You have a sheet that collects customer feedback:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Customer Feedback"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You want a new column with the name ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Feedback (ES)"]},". The Spanish support team can then read the feedback in Spanish."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Row"},"children":["Row"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Customer Feedback"},"children":["Customer Feedback"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Feedback (ES)"},"children":["Feedback (ES)"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The onboarding process was smooth and the support team was very responsive."]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["El proceso de incorporación fue fluido y el equipo de soporte respondió con gran rapidez."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["I couldn't find the export option; the documentation is out of date."]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No pude encontrar la opción de exportación; la documentación está desactualizada."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Feedback (ES)"]}," column, use this column formula:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["=AITRANSLATE([Customer Feedback]@row, \"es\", \"Use formal language\")"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"how-it-works","__idx":5},"children":["How it works:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[Customer Feedback]@row"]},": This is the source text for each row."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"es\""]},": This is the code of the target language. In this example, the language is Spanish."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Use formal language\""]},": This instruction tells the AI to use formal words. Example: \"usted\", not \"tú\"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AITRANSLATE(...)"]},": The function collects the parameters during the column formula calculation. Then it sends an AI event. The system writes the translation in the cell of each row when it completes the event."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The result is a translated column that agrees with the source column. The system also translates new rows when you add them."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-functions","__idx":6},"children":["Related functions"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AISUMMARIZE"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AISENTIMENT"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["LIST"]}]}]},"headings":[{"value":"AITRANSLATE Function","id":"aitranslate-function","depth":1},{"value":"Syntax","id":"syntax","depth":2},{"value":"Sample usage","id":"sample-usage","depth":2},{"value":"Examples","id":"examples","depth":2},{"value":"Example","id":"example","depth":4},{"value":"How it works:","id":"how-it-works","depth":4},{"value":"Related functions","id":"related-functions","depth":2}],"frontmatter":{"seo":{"title":"AITRANSLATE Function"}},"lastModified":"2026-08-26T18:14:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ai-mcp/smartsheet/smart-columns/aitranslate-function","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}