Skip to main content
Official stores provide the simplest installation and update automatically.

Chrome Web Store

Recommended for Google Chrome and most Chromium users.

Firefox Add-ons

Install the signed Firefox build and receive normal add-on updates.

Microsoft Edge

Download the Edge package from the latest GitHub release.

Opera and other Chromium browsers

Download the matching Opera or Chrome package from GitHub Releases.

​
Install a release package manually

Download the correct archive from the latest release:

​
Chrome, Edge, Opera, and Chromium browsers

1

Download and extract the package

Extract the ZIP file and keep it in a permanent location. Renaming the folder to gmail-alias-toolkit makes later manual updates easier.
2

Open the extensions page

Use chrome://extensions, edge://extensions, or opera://extensions, depending on the browser.
3

Enable Developer mode

Turn on Developer mode in the extensions page.
4

Load the extension

Select Load unpacked, then choose the extracted gmail-alias-toolkit folder.
A manually loaded extension does not update automatically. Do not delete or move its folder after loading it, or the browser may disable the extension.

​
Firefox temporary installation

1

Extract the Firefox package

Download and extract gmail-alias-toolkit-{version}-firefox.zip.
2

Open Firefox debugging

Visit about:debugging#/runtime/this-firefox and choose Load Temporary Add-on.
3

Select the manifest

Select manifest.json from the extracted folder.
Temporary Firefox add-ons are removed when Firefox restarts. Use the signed Firefox Add-ons version for normal daily use.

​
Build from source

Requirements: Node.js 24 or newer and Corepack/Yarn.
For Chrome or Chromium, load .output/chrome-mv3 from the browser extensions page. Development and contribution checks are documented in the repository’s CONTRIBUTING.md.

​
Update a manual installation

1

Download the new package

Download and extract the newest package for the same browser.
2

Replace the existing files

Keep the original extension folder path, delete its old contents, and copy in the new package contents.
3

Reload the extension

Return to the browser extensions page and select Reload for Gmail Alias Toolkit.
Keeping the same folder path helps the browser preserve the extension identity and locally stored settings.