Getting started

Start a project

After you sign up to Lokalise, you can get yourself familiar and try a Sample Project or you can start immediately by creating your own project. Click New project button and enter all the necessary details like project name, description, project type, etc.

If you already have an existing project in other translation management system like PhraseApp or Transifex, it is possible to transfer your project to Lokalise choosing the Migrate tab.

Invite team members/contributors

In order to invite contributors, open your project and click Contributors button. You see all the contributors with their names and emails. You may filter contributors by the language they have access too. You may also search for people with the help of the search form.  

To add more people to a project, you have two possible options:

  • Add a contributor by their email
  • Import contributors from a different project

Add a contributor by their email

Invite new user

Click the Invite contributors button, and you will see this dialog box. In the first tab, you may invite a new user who is not yet a member of your team. To do so, enter their email, name, and then assign roles.

  • Adding an admin – toggle the Administrator switch and the user will have the admin rights.  
  • Adding a reviewer – toggle the Reviewer switch and the user will be able to review translations.
  • Adding a translator – toggle the Administrator and Reviewer switches off. Choose reference languages and contributable languages. 

Import contributors from a different project in Lokalise

Click the Import from project button and simply choose one of the projects. Note that already existing users will be left intact and their permissions won’t be affected. Also, if a user from the chosen source project has permission to access only a specific language, but this language is not present in your current project, that user won’t be added as a contributor. 

Add existing users

Choose one of the users from the dropdown list and fill in the other fields which are the same as in Invite new user tab.

User groups

Instead of inviting one user by another, it is possible to add a group of users at once. At least one existing group is required. 

Upload files

Lokalise supports most popular iOS, Android and Web development string file formats. Drag and drop your files altogether or one by one. Alternatively you may use our API, CLI tool or GitHub/GitLab integrations to upload the files. Lokalise will match keys and translations out of the files where possible.

Projects page

This is the page that shows the number of projects you have, and provides a summary for each. This includes:

  • Project completion – you can track the overall progress here
  • Base words – how many words in total are in this project
  • Keys – the total amount of keys in this project. Keys are unique identifiers that are used for representing text in the code, in files or elsewhere.
  • QA issues – you can click and track any issue that our automatic checker has found. These may be grammar\spelling errors, translation reviewing issues, etc.

Apart from looking at overall project info, you can track the progress of each relevant language separately. 

Product overview

Interface

  1. Checkboxes – select one, multiple or all keys in the list and perform an action on them
  2. Filter  – to see only specific strings or keys.
  3. Key sorting – e.g., first added or last added.
  4. Toggle between multilingual and bilingual view.
  5. Bookmark your position in the project.
  6. Enable to display placeholders/HTML tags as blocks.
  7. Filter – only show keys with screenshots.
  8. Add a new language to the project or open the language settings by clicking any language icon. 
  9. Search keys by the name or a part of the name.
  10. Key counter – shows how many keys are displayed using the current filter(s). 
  11. Add a new key to the project.
  12. Find/Replace strings within the project.
  13. Built-in translation memory.
  14. Magic scroll that helps navigate the keys quickly.
  15. Key name, attributes and quick actions.
  16. Translations and key editor.
  17. Project related actions and widgets, e.g., manage files and tasks.

Learn more.

Upload screenshots

Drag and drop the screenshot files (JPG, PNG) to the drop area. Lokalise will automatically recognize the text on the screenshots and link the uploaded screenshots to the keys so they show up in the editor.

Automatic key tagging system is able to recognize the text on the screenshots, if the text meets the following conditions: 

  • Only the base language values can be recognized. The supported languages are English, Russian, German, Spanish, Italian, Swedish, Finnish, Turkish, Polish.
  • Automatic key tagging is able to recognize only the existing keys. Please make sure that the key already exists, before trying to link it to the screenshot. 
  • The text must be clearly seen on the screenshots. Depending on the font, background and image quality the automatic key tagging may or may not not recognize some strings.

Glossary

Some words should stay the same in all languages. For example, company names. Our Glossary allows you to add any words that require special treatment. For example, Lokalise is a company name and shouldn’t be translated - you turn the Translatable button off.

Also, there are some words which have more than one meaning. You can add them to glossary too and write a short explanation.

Project activity

You can track the all project activity. Check what has been done by a specific person in any period of time. There is a list of different activities, which help to filter the unnecessary information out. 

Project statistics

The Statistics module provides you additional insights on your current project translation state. You can check:

  • Translations by language 
  • Translations by contributor 
  • Words translated for selected period 
  • Words translated for all time

Snapshots

You can create and retrieve a project snapshot (backup) any time by going to project settings following Snapshots tab. Even more, the project snapshots are created automatically once you import new strings or perform a search/replace, so you can always revert back to previous version (enable Automatic snapshot on upload). Data recovery made quick and easy.

Download files

You can download (export) your project strings to any format Lokalise supports. Alternatively, you can initiate the export via API.

Translation memory

This feature is extremely useful if you work in more than one project. Translation Memory remembers the accepted translations and will offer them to your translators in other projects. There are two ways of accessing this feature:

  1. The translation will be suggested automatically when you click on the translation field
  2. You can click on the Translation Memory button (or summon it with ctrl-G) and search for translations manually

QA checks

There are 13 QA checks you may enable or disable in your project with 2 QA escalation levels: Warning and Error. 

  • Warning level – the translation edition will be saved as usual, just a notification icon with a warning will pop up in the Editor. 
  • Error level – prevents a translator from saving the entry in the web UI (the Editor).

Language auto-fill

Often there are several language variations in the same project which have just small differences, e.g. English, English US, English UK. Instead of copy/pasting the translations, you can set up auto-fill rules in order to make the updates automatic.  

Integrations 

Integrate Lokalise with the tools you love and use every day. Connect with your favorite productivity tools and code repositories. You can also set up new workflows and event triggers via API and make the translation process seamless.

There are several types of integrations available:

  • Events and actions – with this type of integration you select Lokalise events that should trigger the integration. Examples: Slack, Webhooks, E-mail, Jira, Trello.
  • Data exchange – this type of integration ensures import and export of your data. Examples: Zendesk, Github 
  • Developer tools – we provide the tools to use in your scripts and frameworks. Examples: CLI, iOS, SDK, CakePHP

Mobile in-context editor

Lokalise iOS SDK Live Edit Module  is the extension of Lokalise iOS SDK. Translate the app in Lokalise while navigating it on a connected mobile device — the best in-context translation experience. Instantly see the changes made and ensure the app is pixel-perfect. 

The screen mirrors the linked device with installed prerelease version of your app. First, it provides an editor or a QA / LQA specialist with the live full context of the translated string. Second, it ensures the pixel-perfect visual experience, showing the edited strings in proper font, proper place, just as the end users will see it.

Web in-context editor

LiveJS is an in-context JavaScript editor that lets your translators or copywriters edit your website texts and translations right on the webpage. All changes are shown in the browser and saved directly to Lokalise, not to your localization files or database running your web. 

Translation order


In case you don't have your own team of translators, Lokalise offers several translation providers, that can help translating your app or website to the most popular languages. Simply upload your source files into the project and use Orders menu to get an instant quote.
In addition, we offer our own translation services with a lifetime quality guarantee. Prices start from €0.07/word.

Manage your team

Team roles

A team can contain many users, and a user may be a member of many teams. 

If a user is a member of a team, they may have one of the following roles

  • Owner – the user who initially created the team becomes owner automatically. An owner can promote team users to owners. The owners are automatically added to all projects created in a given team. They cannot be removed from those projects. Owners may delete users, projects, and perform other administrative actions.
  • Administrator – may promote team users to administrators, remove users, create projects and orders, subscribe, download invoices and change billing details. 
  • Member – team members have restricted rights: they cannot modify any team settings, manage users, or view sensitive data like billing information.

To change user’s permissions, click on the name of a role and choose another role from the list. 

Add a team member button will add users to projects. Once a user joins a project, they will become a member of your team. 

When you create a new project in Lokalise, you and all team owners are added to this project. These initially added users have full access rights and may perform translations, add or remove keys, invite new users, change settings etc. 

User groups

Create a new group by giving it a name, and then click Add members. After that, open the Permissions tab, where you will find familiar controls. Using these controls you may assign permissions to all users of the current group.

Subscription

In order to choose the most suitable subscription plan, navigate to Team settings and choose the Subscription section. There you can see your current subscription plan and the expiration date. Click on the Change current plan and you will be redirected to our pricing page.

Contributor rights and roles

Administrator or admin – have full read and write access to all project languages which means that they can change any translation. Additionally, you may choose what other actions the admins may perform. For example, you may allow or disallow to upload, download files, or manage contributors.

Translator – can read and edit translations in your project. You may cherry-pick which languages a translator can access. 

Reviewer – admins and translators can be assigned a reviewer role. Reviewers are responsible for quality assurance. They are able to mark translations as “reviewed” effectively saying that this translation is correct and can be used in production. This role is available only if you have reviewing feature enabled in the Project settings. 

Tasks

Create a better-structured localization and translation workflow with tasks. They help you to better manage your translators and keep track of their jobs. You can see which job the contributors are currently doing and what is the current progress.
By assigning a task, you can define the amount of keys, languages, due date, etc. A good idea is to restrict contributors to work within tasks only by checking a box in Project settings. 

On the first screen enter the following info:

  • Title of the task 
  • Description (optional)
  • Due date (optional) 
  • Task type which can be either translation or revision:

Translation means that the assignees have to translate a number of keys to the chosen languages.

Revision means that the assignee has to verify translations and make sure they are correct.

On the second screen you may choose task options:

  • Lock translation – the keys chosen in this task will be editable only by the assignee of this task. Other project contributors won’t be able to modify these translations until the task is done.
  • Include admins as assignees – you will include yourself and other administrators of the project in this task.
  • Auto-close languages – when all chosen keys are translated to a specific language, the language will be marked as completed and the corresponding subtask will be closed.
  • Auto-close task – when all the languages for this task are closed, the whole task will also be closed automatically.
  • Save initial TM leverage – you use this information in order to pay fairly to translators taking into account the time they save by using your Translation Memory, i.e. your past translations. At the moment of creating a task, the system will calculate the initial Translation Memory leverage and save it in the task details for later use.
  • Tag keys as the task is completed – if you choose this option, you may enter one or more tags that will be automatically added to the keys once the task is done. Tags act like labels and can be used to quickly filter keys.

Task scope – using the filter you may select keys to translate. By default, all untranslated keys are selected, but you may modify or add more filters. 

Target languages – select one or more languages from those in your project. 

Assignees – to add someone to work on a language, click on this box and choose one or more users. 

Create task – once this button is clicked assignees will be notified that they have a new task. You may add or remove translators by clicking the avatars inside the task box.

Once you assign a task for contributors, the badge will pop up in their Task Inbox. In addition, they may receive a notification via email. Translators can track the progress, see the due date and task description.

That's it! We'll keep updating this guide. If you have any questions or suggestions, please contact us in the support chat. 

Did this answer your question?