Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

FAQ: Shutting down Pootle and migrating to Pontoon

Q: What are the first things I need to do in order to adapt to Pontoon?

There are a few things you can do to make the transition run smoothly:

  1. Log into Pontoon with your Firefox Account. If you don’t already have a Firefox account, please create one.
  2. Check your permissions on your profile to make sure they match what you’d expect.
  3. Flag issues with Pontoon to the l10n-drivers so that we can triage them and address them in a timely manner. To do this, please file a bug here, or reach out to the l10n-drivers if you’re not yet comfortable with Bugzilla.

If you’re a locale manager on Pootle, check the community permissions on Pontoon and make any necessary changes to mirror your community’s permission settings.

Q: When is my locale going to be migrated to Pontoon?

We plan to migrate one project at a time to Pontoon, starting with those that don’t have upcoming deadlines. We’re going to announce the deadline for each project across our communication channels, in order to give you a chance to review pending suggestions.

If your locale is up to speed, doesn’t have any pending suggestions, and you prefer to migrate all projects at once, please get in touch with l10n-drivers to coordinate the process.

Q: Will there be a training session, doc or video on how to use Pontoon?

We’ve created this set of documents to instruct on the basics of using Pontoon. We’ll add more and more to these docs as time goes by. You’re also welcome to add to that doc by submitting pull requests to the localizer documentation GitHub repository.

Q: What will happen to my user profiles translation stats on Pootle?

We have performed a database dump of all Pootle data. We’re working to sort out how to migrate actions like submitted or approved translation attribution over to Pontoon.

Q: How are user rights distributed in Pontoon?

Pontoon has three user types with specific rights:

  • Contributor - authorized to make translation suggestions.
  • Translator - authorized to review translation suggestions and submit translations.
  • Manager - authorized to review translation suggestions, submit translations, and adjust the user rights of people within the community

Unlike Pootle, there’s no difference between the ability to review suggestions and submit translations. This document describes user roles in Pontoon with more details.

Q: What happens to unreviewed suggestions on Pootle?

Unreviewed suggestions will not be migrated to Pontoon. That’s why it’s mandatory to review pending suggestions before a project (or the entire locale) is migrated.

Q: Is there a Terminology project in Pontoon?

No. We’re rolling out terminology support by the end of September in two stages:

  • Stage 1: we’ll add support for using terminology in the Translate view: matched terms in the source string will be highlighted, providing definitions and possible translations for them. In this stage we’ll use Microsoft Terminology as a read-only data source.
  • Stage 2: we’ll add a terminology management interface, and refine the UI based on the results of the previous stage. This will allow to translate a set of Mozilla specific terms, which will then be used as a terminology source like the Microsoft Terminology introduced in Stage 1.

Q: How do I localize the Pontoon interface?

Currently, Pontoon is not localizable (yes, we see the irony). That work still needs to be scoped and added to the Pontoon roadmap. We’ll keep everyone posted.

Q: Are the numbers word count or string count in Pontoon?

For now, Pontoon counts strings, not words. We’ll be adding word count soon.

Q: For locales who want to keep using Pootle, what options do they have? Would it be possible to run a local instance of Pootle?

A: There’s a lot of development that Pootle would need to experience in order to keep pace with the technological changes coming to Firefox development. For example, l20n is already in Test Pilot projects and is coming to Firefox soon; Pootle would need to be able to support l20n in order for localizers to continue using it. Without the necessary funding to perform that development and maintenance, any community-run instance of Pootle will quickly become obsolete.

Q: Supposing I want to use an alternative l10n tool to Pontoon for my community, what technical requirements would qualify a l10n tool for use in contributing to Mozilla l10n projects?

A: We assume that all tools used for localization at Mozilla are capable of:

  1. Bidirectional sync with version control repositories (for example allowing us to migrate content from the old format to FTL seamlessly for localizers).
  2. Committing with appropriate attribution to version control repositories.
  3. Support for l20n (.ftl format), including a GUI to facilitate the use of FTL syntax in translated strings.
  4. Support for the upcoming central project configuration (part of cross-channel).

This list will be amended over time to suite Mozilla’s needs for localization.

Q: Does Pontoon allow to download content in Gettext format, to feed other l10n tools or translation memories?

A: It’s currently not possible to export strings in Gettext (.po) format from Pontoon, unless that’s the format used in the project itself. Even in that case, you can only download one file, not the entire project. It’s possible to download each resource (file) in TMX format.

Note that Gettext format is not capable of storing data encapsulated in FTL. That means that it will not be possible soon to export Firefox localization resources to PO.