Translating Files

Managing Business Documents

In addition to apps and websites, Smartling also helps you translate your business documents, including Microsoft Word (.docx & .doc), Excel (.xlsx), Powerpoint (.pptx) and Adobe InDesign (.idml). You can create a dedicated Business Documents project for your files, or upload business documents to any Files project.

Strings and Segments

To translate your business documents, Smartling parses the content into ‘strings’: individual blocks of text that translators can easily work with. Parsing differs depending on the document type.

  • MS Word: Each paragraph is captured as a string. A new paragraph or line break creates a new string.
  • Excel: Each cell of the spreadsheet is captured as a string in the Smartling dashboard, including the sheet tab name. Data as a result of a formula is not captured and must be typed into the cell without any formulas. Numbers are also not captured unless it is formatted as a text from the format dropdown.


  • PowerPoint: Each text box on a PowerPoint slide is captured as a string. The strings are arranged in order of when each text box was created, not where it is placed on the slide.
  • IDML: Each paragraph within a text frame is captured as a string. A new paragraph or line break creates a new string.

Remember: text that is part of an image cannot be captured for translation.

Each string may be further divided into segments, only visible in the CAT tool. A segment is usually a sentence, with a sentence-ending punctuation mark such as a period (.), exclamation point (!) or question mark (?) creating a new segment.

Excluding content for translation using Styles

See "Excluding Content" for detailed directions on how to use "styles" in your Microsoft Documents to prevent content from being translated.

Uploading and Downloading Files

Uploading business documents for translation and downloading translated files follows the same process as resource files, but Business Documents have the extra option of ‘Updating’ a file.

Updating Files

When you need to make changes to a Business Document in translation, it’s important to remember that if you upload a similar file with a new filename,for example, File1-1.docx, then File1-2.docx, Smartling will treat it as a completely new file, which may affect billing and cause unnecessary duplication of strings in your project.

Instead, consider using the Update File feature. Updating a file will capture only the parts you have changed as new strings.

To update a file, click it’s card on the Files screen, select Update File and browse to the correct file. Updating the file will change the content of the file, but not the file name.


After you have updated a file, you may want to rename it to match the most recent version. To rename a file, mouseover the name and click the Pencil icon.


You can achieve the same effect as updating by uploading the changed file again as long as you haven’t changed the file name. You will be prompted to confirm that you want to overwrite the existing file. This action will capture only the parts of the document you have changed as new strings.


Adding Instructions

When you upload business documents, Smartling parses all the main text of the document as translatable content, so any notes for translators or explanation of the document not intended to be included in the translated file should be removed. However, you can add instructions to a file within Smartling to give translators any extra information they need. There are two ways to do this:

  1. Upload instructions from the Files screen. Click the file card, select your source language and click Add File Instruction. Instructions can be any file type you want and will be available in the CAT tool for any strings from that file.
  2. Find any individual string in the list view and click the instruction icon to add instructions for that string.

Was this article helpful?