Starting a new MDN localization

If your language doesn't already have a localization project on MDN, and you have the time and the enthusiasm to do so, you should consider starting a new one. This article is a guide to how to go about starting a localization project.

Getting started

If you'd like to start a localization project to translate MDN into your language, here are the steps you need to follow to get up and running.

  1. First, check to see if there's already a localization for that language.
  2. Contact your locale's Mozilla l10n team and let them know that you want to start it.
  3. Sign up to our Mailing Lists and head to the #mdn IRC channel on
  4. Contact the MDN administration team to let them know you're starting a new localization. You don't need their permission or anything, but we likes to know who you are. Let us know a little bit about you and which locale you're planning to start work on.
  5. Add a row for your language to the list of localization projects, and include anyone else who is planning to work on it.
  6. Create a bug in Bugzilla requesting that your language be added to the list of languages supported by MDN. This bug should be in the "Mozilla Developer Network" > "Localization" category. It will be automatically assigned to the correct person. This is needed so that your language shows up in the list of languages to choose from on the site; until this is done, you won't be able to continue.
  7. Wait while the MDN team handles your request. If your bug isn't responded to within three or four days, please add a comment to the bug asking for an "ETA" for completion.
  8. Once the locale has been added to MDN, you can use the Verbatim tool to translate the user interface strings for the site, and you can begin translating articles on the wiki. While translating the site's strings in Verbatim isn't required, it does add a nice touch to have the user interface presented in your language.

Organizing a localization project

There are lots of great tips from various existing translation teams; you should feel free to adopt any of these ideas you choose. In addition, please feel free to add your own suggestions as well. See this template in the Spanish wiki for an example.

  • Use a macro to identify articles that are in the process of being translated. The macro should provide an information box that includes a link to the original version of the article. You may also wish to use page tags to indicate pages that need more translation work. This helps track articles that are in the process of being translated.
  • Use a macro to include articles that need to be translated in article lists with a flag or marker next to them indicating that the article hasn't been translated yet. This is a way to advertise important articles in need of translation. See this template in the Spanish version of MDN for an example.
  • Make use of the "Needs technical review" and "Needs editorial review" flags, to mark articles that have been translated but should be double-checked for technical and grammatical accuracy.
  • Use the "junk" tag to mark pages that need to be deleted. Since only admins have access to delete articles, this provides a way to mark that an article is obsolete until the admins get the page deleted.
  • Be sure to include translations of these MDN "how to" pages, and include additional pages as necessary to explain your localization team's policies and practices.

To find help with your project, be sure to ask around on the dev-mdc mailing list, the #devmo IRC channel, and other MDN-related discussion areas. See "Join the MDN community" for pointers to community discussion channels that will help you find others interested in joining your localization team.

You may also be able to find others interested in helping you by attending local Web development events, at your local hacker space, and the like. Be creative!

Localization look and feel

The basic structure of each of the localizations of MDN should be essentially the same. In general, you should try to maintain the same hierarchy of pages, so that each page on each language corresponds to a similar page in each locale.

You are welcome to link to external local pages, write your own articles, and translate everything from the English wiki. If you do decide to write your own articles, it would be helpful if you could provide an English translation for the English wiki so it can then get translated into all of the other localized wikis.

Adding local resources you should keep a neutral point of view; that is, you shouldn't promote a particular perspective, and should instead simply provide the facts as best as possible (see information about the NPOV rule on Wikipedia). You should not link to commercial sites (like paid courses, web design companies, etc.). You should promote open standards and cross-browser compatibility over closed or proprietary methods wherever possible.

Note: Team leads are encouraged to monitor their locale's content for spam and other inappropriate materials and take steps to get them removed or corrected.


All materials created and translated for the MDN should follow our Copyright and Licensing Policies.

If you encounter problems of any sort—technical, policy, or other—please contact the MDN admin team.

See also