Skip to content

Commit a68b346

Browse files
rebloordotproto
andauthored
Issue-1185 localization testing page (#2190)
Co-authored-by: Simeon Vincent <svincent@gmail.com>
1 parent 5b86caf commit a68b346

File tree

2 files changed

+46
-0
lines changed

2 files changed

+46
-0
lines changed
Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
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 -->

src/data/pages.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -643,6 +643,10 @@
643643
}
644644
]
645645
},
646+
{
647+
"title": "Testing localizations",
648+
"url": "/documentation/develop/test-localizations/"
649+
},
646650
{
647651
"title": "Known issues",
648652
"url": "/documentation/develop/known-issues/",

0 commit comments

Comments
 (0)