Transifex

  • Documentation
  • Getting started as a localization manager
  • 1. Set up your projects

1. Set up your projects

Create an organization

First things first: you need to create an organization within Transifex - this is where all your translation management activity will happen. Transifex is set up as a directory of projects, projects contain resources.

Read more about creating an organization and organization structure here.

Create a project

Next, create your first project by following these steps.

File-based and Live projects

File-based project works with files (e.g. .po, .yml, .strings) - where you upload the files to Transifex, get them translated within Transifex, then pull them back to your development environment. 

Live project is a java-script-based approach, great for translating not too dynamic websites  - where Transifex identifies the strings to translate on the front end and serves the translations back to your website.

Source and Target Languages

When choosing a source language, make sure that you stay consistent across all your projects: e.g. if you choose generic “en” in your first project, choose it in all subsequent projects that you or your team members create later on. This will help such great features as Translation Memory and Glossary work fine and be shared across all your projects. 

When choosing target languages, our recommendation would be to choose a locale-specific target language (e.g. es_ES vs es). Unless you have a particular reason to use generic language codes, it’s better, for the sake of clarity, to specify the locales, especially for the dialects such as French (France and Canada), Spanish (Spain and Latin America), Portuguese (Portugal and Brazil), and Chinese (Simplified and Traditional).

With target languages, similarly to source languages, make sure to stay consistent when adding languages across your projects in Transifex: if you chose “es” for Spanish-Spain, stick to it across all your projects.

Upload content

There are a few ways to move your content to Transifex for translation:

  • Uploading the files into projects manually (read more here)

  • API (read more here)

  • CLI Client (read more here)

  • Integrations with the tools you use (read more here)

Read more about the supported file formats here.

If you get file upload errors for a supported format, you can send support@transifex.com a sample of the file and we can help assess why the upload failed and provide further recommendations.

A few things to keep in mind:

  • The source file you upload should only have source strings in it, not translations. After adding your source content to Transifex, you'll be able to upload existing translations.
  • If you have an existing TM, make sure to upload the TM to leverage it in all translation work.