Adding Extensions using the Windows Registry

  • Revision slug: Adding_Extensions_using_the_Windows_Registry
  • Revision title: Adding Extensions using the Windows Registry
  • Revision id: 59641
  • Created:
  • Creator: Nickolay
  • Is current revision? No
  • Comment

Revision Content

Introduction

This document explains how to "install" Firefox and Thunderbird extensions using the Windows Registry. This mechanism is designed to make it easier for third-party installers to register extensions with Firefox and Thunderbird.

Note The mechanism described in this document requires Firefox/Thunderbird 1.5 or later.

Installation

Installation is performed by writing a Registry entry under one of the following keys:

HKEY_CURRENT_USER\Software\Mozilla\Firefox\Extensions
HKEY_LOCAL_MACHINE\Software\Mozilla\Firefox\Extensions

For Thunderbird, replace Firefox with Thunderbird.

The ID of the extension must be used as the name of the Registry entry. The Registry entry must have a type of REG_SZ, and its value must be an absolute path to the folder containing the extension. For example, to install the extension described here, create a Registry entry with name equal to sample@foo.net and value equal to c:\extensions\myExtension.

After the Registry entry is created, Firefox/Thunderbird will notice the change the next time it is launched. It is safe to modify the Registry keys while Firefox/Thunderbird is running.

If the same extension appears under both HKEY_CURRENT_USER and HKEY_LOCAL_MACHINE, then the instance under HKEY_CURRENT_USER will be used. If the same extension appears in the user's profile directory (via manual install), then it will take precedence over any instances found in the Registry.

Uninstallation

Extensions installed using the Windows Registry may be uninstalled by simply removing their corresponding Registry entry. After the Registry entry is removed, Firefox/Thunderbird will notice the change the next time it is launched. It is safe to modify the Registry keys while Firefox/Thunderbird is running.

See also

Extension Packaging

Revision Source

<h3 name="Introduction"> Introduction </h3>
<p>This document explains how to "install" Firefox and Thunderbird <a href="en/Extension">extensions</a> using the Windows Registry.  This mechanism is designed to make it easier for third-party installers to register extensions with Firefox and Thunderbird.
</p><p><b>Note</b> The mechanism described in this document requires Firefox/Thunderbird 1.5 or later.
</p>
<h3 name="Installation"> Installation </h3>
<p>Installation is performed by writing a Registry entry under one of the following keys:
</p>
<pre class="eval">HKEY_CURRENT_USER\Software\Mozilla\Firefox\Extensions
HKEY_LOCAL_MACHINE\Software\Mozilla\Firefox\Extensions
</pre>
<p>For Thunderbird, replace <code>Firefox</code> with <code>Thunderbird</code>.
</p><p>The <a href="en/Install_Manifests#id">ID</a> of the extension must be used as the name of the Registry entry.  The Registry entry must have a type of <code>REG_SZ</code>, and its value must be an absolute path to the folder containing the extension.  For example, to install the extension described <a href="en/Building_an_Extension">here</a>, create a Registry entry with name equal to <code>sample@foo.net</code> and value equal to <code>c:\extensions\myExtension</code>.
</p><p>After the Registry entry is created, Firefox/Thunderbird will notice the change the next time it is launched.  It is safe to modify the Registry keys while Firefox/Thunderbird is running.
</p><p>If the same extension appears under both <code>HKEY_CURRENT_USER</code> and <code>HKEY_LOCAL_MACHINE</code>, then the instance under <code>HKEY_CURRENT_USER</code> will be used.  If the same extension appears in the user's profile directory (via manual install), then it will take precedence over any instances found in the Registry.
</p>
<h3 name="Uninstallation"> Uninstallation </h3>
<p>Extensions installed using the Windows Registry may be uninstalled by simply removing their corresponding Registry entry.  After the Registry entry is removed, Firefox/Thunderbird will notice the change the next time it is launched.  It is safe to modify the Registry keys while Firefox/Thunderbird is running.
</p>
<h3 name="See_also"> See also </h3>
<p><a href="en/Extension_Packaging">Extension Packaging</a>
</p>
Revert to this revision