In Lokalise, with new document file support, you can upload, translate and download DOCX and HTML files without the need to create key entries. The feature is available from the Essential plan. 

Project type differences

The Editor for document files is a little different compared to Lokalise’s standard key-value Editor. Main options stay the same, however, there are some limitations:

  • Fewer integrations (some platforms do not support the DOCX format)
  • Less upload and download options
  • Cannot add new keys/paragraphs within the Editor

How to start

In order to start using this new feature, you have to create a new project and choose the Documents project type. The support for PDF, InDesign, and other formats is coming soon.

Uploading the documents

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

Dashboard overview

The dashboard menu stays the same. You can see the overall progress of your project as well as the languages. Yet there is a small change: our new feature for the document file support tracks the progress of each document in the project separately. Adding language is also possible from the dashboard.

In addition, you can manage your documents by renaming and deleting them straight from the dashboard.

Editor overview

The Editor allows you to add new languages and track the translation progress. Note that for document file Editor:

  • Only the bilingual view is available
  • you cannot edit the source language
  • It is not possible to add new keys in the Editor

Even though it is not possible to add new keys, you can add new paragraphs. In order to do that, or also when you are updating the text in the source language, you need to:

  • open your initial DOCX file
  • make the necessary changes there
  • upload the modified\updated file choosing replace modified values option

Your translations will remain safe — everything stays the same, only new paragraphs will be added.


Our platform allows you to upload documents without having to alter the document structure. Images will be uploaded to Lokalise even though 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?