|
| 1 | +--- |
| 2 | +layout: sidebar |
| 3 | +title: Testing localizations |
| 4 | +description: Learn how to test extension localizations using language packs in Firefox or Firefox Beta to ensure everything displays correctly in the Firefox and extension UI. |
| 5 | +permalink: /documentation/develop/test-localizations/ |
| 6 | +topic: Develop |
| 7 | +tags: [add-ons, extensions, guide, permissions, testing, webextensions, localization] |
| 8 | +contributors: [rebloor] |
| 9 | +last_updated_by: rebloor |
| 10 | +date: 2025-10-17 |
| 11 | +--- |
| 12 | + |
| 13 | +<!-- Page Hero Banner --> |
| 14 | + |
| 15 | +{% capture page_hero_banner_content %} |
| 16 | + |
| 17 | +# Testing localizations |
| 18 | + |
| 19 | +To test your extension's localization, you use [Firefox](https://www.firefox.com/en-US/) or [Firefox Beta](https://www.firefox.com/en-US/channel/desktop/), the Firefox builds where you can install language packs. |
| 20 | + |
| 21 | +{% endcapture %} |
| 22 | +{% include modules/page-hero.liquid, |
| 23 | + content: page_hero_banner_content |
| 24 | +%} |
| 25 | + |
| 26 | +<!-- Content with Table of Contents Module --> |
| 27 | + |
| 28 | +{% capture content %} |
| 29 | + |
| 30 | +For each locale supported in your extension, follow the instructions to [Use Firefox in another language](https://support.mozilla.org/en-US/kb/use-firefox-another-language) to switch the Firefox UI language. (If you know your way around **Settings**, under **Language**, use **Set Alternatives**.) |
| 31 | + |
| 32 | +When Firefox is running in your test language, from `about:debugging`, [install the extension temporarily](/documentation/develop/temporary-installation-in-firefox/) or reload it if it's installed. After installing or reloading your extension, if you've set up your extension correctly, you see it listed with its icon, name, and description in the chosen language. You can also see the localized extension details in `about:addons`. Now, exercise the extension's features to ensure the translations are in place. |
| 33 | + |
| 34 | +To try this process out, use the [notify-link-clicks-i18n](https://github.com/mdn/webextensions-examples/tree/main/notify-link-clicks-i18n) extension. Set up Firefox to display one of the languages supported in the example (German, Dutch, or Japanese). Load the extension and go to a website. Click a link to see the translated version of the notification reporting the link's URL. |
| 35 | + |
| 36 | +{% endcapture %} |
| 37 | +{% include modules/one-column.liquid, |
| 38 | + id: "test-localizations" |
| 39 | + content: content |
| 40 | +%} |
| 41 | + |
| 42 | +<!-- END: Single Column Body Module --> |
0 commit comments