This feature is available from the Essential plan and above.

In Lokalise, with the new document file support, you can upload, translate, and download DOCX, PPTX, IDML, and HTML files.

Please note that if you need to translate a text document (.doc, .rtf, .pdf, or any other similar format), you can order a professional translation as explained in the corresponding article (make sure to choose Gengo provider).


Project type differences

The project editor for document file types is a little different compared to Lokalise’s standard key-value editor. The main options stay the same, however, there are some limitations:

  • Fewer integrations (some platforms do not support the DOCX format).

  • Fewer upload and download options.

  • Inability to add new keys/paragraphs or remove the existing ones within the editor.

  • Multilingual view is not available for Documents projects.

How to start

In order to start using this new feature, you have to create a new project and choose the Documents project type.

Uploading the documents

Open your project and proceed to the Upload page:

Import or drag a file you want to upload and choose any other relevant options, if needed. In the context of document files, paragraphs are accounted for as keys. One paragraph = one key.

Project dashboard overview

Document type projects are displayed in a very similar way to software localization projects. In the dashboard you can see the overall progress of your project as well as that of the languages. Yet, there is a small change: you can track the progress of each document in the project separately. On top of that, you can rename and remove individual documents:

Editor overview

The project editor allows you to add new languages, perform translations, and track translation progress.

Even though it is not possible to add new keys, you can add new paragraphs. In order to do that:

  • Open your initial DOCX file.

  • Make the necessary changes there.

  • Upload the modified file while choosing the replace modified values option.

Your translations will remain safe — everything stays the same, except for the newly added paragraphs.

The same approach can be applied to other documents, for example PowerPoint presentations: simply open it, make the necessary changes, and upload the modified file once again. Note, however, that if you have reordered paragraphs in your document and uploaded with the replace modified values option enabled, the result might be unexpected.


Our platform allows you to upload documents without having to alter the document structure. Images will be uploaded to Lokalise even though they will not be displayed inside the editor. You will get the images back in the right places when you export the file.

Did this answer your question?