How to update Firefox or Thunderbird addons to work with a new release

Have you ever got used to a Firefox or Thunderbird addon that you really like, or just can't live without, and then a new version of either Firefox or Thunderbird is released, and suddenly your addon no longer works?

Of course, the generally recommended way is to search for a new version, but sometimes when you try to update your addons, you find there is no new version, or it seems like nobody is maintaining the addon any more. I tend to live on the leading edge of new Firefox releases, I want the new features, I want the latest, and I want it now, so I quite frequently hit this problem. Fortunately, there is an easy way to keep using your favorite addons, usually with little or no risk.

Before my instructions on hacking an add-on however, if you want an easy way out and don't mind the overhead of yet another add-on (which in my mind performs very little useful purpose, but you are welcome to your opinion on the matter), and don't mind the following recommendation, "Note: Recommended for alpha and beta users only!", you can install an official Mozilla add-on, the Add-on Compatibility Reporter. If this suits your needs and you can live with the overhead, wonderful. Read no further, go ahead and install the add-on. If like me, you prefer to minimize your add-ons to optimize resource utilization (read memory and CPU cycles), then you might prefer to try my method.

The first version of this add-on, version 0.1 was released in October 2009, ten months after my initial posting of this article. They are now at version 1.0.2 which should by now be reasonably mature and stable, but reading some of the comments posted by users of the add-on, and the Mozilla recommendation as to the intended user of the add-on, I am no more interested than when this add-on was first mentioned to us.

The summary for those who just want to skim and jump in:

  • Download the addon file you want to update
  • Rename the addon archive file to add .zip to the end
  • Extract install.rdf
  • Edit install.rdf, find and change maxVersion, save the change
  • Pack install.rdf back into the install archive
  • Rename the file back to it's original .xpi name
  • Install by dragging and dropping the modified .xpi file, or for older versions of Firefox and Thunderbird if drag and drop is not supported, install using using the menu options File, Open, and choose the modified .xpi file.

The detail for those who need all the steps:
You will need only two free tools to help you do this job, and in this age I think it is reasonably safe to assume that virtually every user already has a copy of WinZip, the totally free 7-Zip or some other ZIP file management utility and hopefully knows how to use it. The other tool is a simple text editor. Microsoft's Notepad will do, but any other text editor will work if you have any particular preference. My preference is NotePad++ which is a good free programming and general purpose text editor.

A warning is the first important note here; always backup your Firefox or Thunderbird installation directory before doing any "hacking". While a problem is extremely rare, problems can happen, and you will only have yourself to blame if you don't take appropriate precautions before making any unsupported changes. I won't take any responsibility for any problems you inflict on yourself through sharing with you what I do on my own computer(s). It is often a good practice anyway to backup your installation directory before installing any new addon, just because you never really know what can happen, though usually by the time anything is approved and available for public download on, it has been fairly well tested by others and proved to be safe. At the very least, before following my tips here, backup your profile and addons directories by making a copy of them to some other location on your disk. If you don't know how to do that, or don't know where your profile and other directories (folders) are, I don't suggest you try my tricks. Read Gizmo's article How to Back up Mozilla Firefox and Thunderbird, in which among other things Gizmo mentions using tools such as MozBackup which shields you for knowing how to do it manually.

Once you have taken your backup, the first step is to find and download the latest version of the addon you want, and download a copy to your disk. Remember, at this point you can not simply click the Install link, because you know the installer will tell you the addon is unsupported for your version of Firefox or Thunderbird, which is more than likely why you are reading this article! Normally, you would click the Install button, but in this case, you want to save the file to disk, so right click on the install (or Add to Firefox / Add to Thunderbird) button, and then click 'Save Link As'. Choose a location on your disk, make a new folder if necessary. The file you download will be named something like better_gmail_2-0.6-fx.xpi. On rare occasions you may find that when using Firefox, you just can't click 'Save Link As' for some reason. Try a different browser, you may have better luck saving the file when the browser itself is not capable of actually installing the addon.

Having saved the addon, you will need to extract one file named install.rdf from it, make a change, and then pack it back into the file. Since the addon is just a zip file containing all the supporting files necessary for the addon, the easiest way to extract files is to rename the original by changing the .xpi extension to .zip, or by simply adding .zip to the end of the file name temporarily. You will need to extract the install.rdf file from the zip file, edit it, and then put it back in again, so if you're not comfortable with these tasks without me describing them in great detail, don't try. Ask somebody else who is comfortable using zip to extract a file and pack it back in again to help you with this process.

Once you have the install.rdf file extracted, open it with your text editor, and look for lines like the ones listed below. Many addons don't have these lines, so they are not checking for specific versions, and you should not see any incompatibility messages.

The part you need to change is the line with the maxVersion setting. As long as I am running Firefox 3.0.1, this addon should work for me, but when I upgrade to 3.1, or 4, it will no longer work. The next step is to change the maxVersion setting to at least the version you are currently running, I usually just change it to 9.0 which means I can run any version that will be released for some time to come. You can actually set the maxVersion to *.* and never have to worry about future Thunderbird updates, but ideally you should also get official add-on updates as they are released.

If your install.rdf looks really weird when you open it, and seems to have just a few lines that look really long, and don't all display on the screen, don't panic. Most likely, the addon programmer has used a Unix or Linux system to create the files, or they have used an editor that does not automatically wrap lines. The Unix or Linux option may be the more likely of the two, and if you don't know what I mean by line termination characters and vi, explaining more would only confuse you even more. Either way, some Windows text editors will know what to do with a non-typical Windows text file, Notepad will not, so if you see just a few long lines, just use Ctrl F, or click Edit, Find, and then type maxVersion. All you need is to find this setting, change it, and save it. Don't worry about the strange file formatting.

After making the change, save the install.rdf file, pack it back into the addon zip archive, and rename it back to it's original name ending in .xpi. The last step is to actually install it, and to do this, procedures are slightly different for Thunderbird versions prior to 7, and for v 7 and later.

For Thunderbird versions prior to v 7, rather than browsing to, simply click File, Open File, select your modified .xpi file and click the Install Now button. At this point, unless you made any mistakes or any other problems were detected during installation, your addon is installed and will be ready for use when you restart Firefox. The same should all be true for Thunderbird addons.

For Thunderbird 7 (and presumably later) the process has changed slightly but is still just as easy. Instead of File, Open File and selecting the modified .xpi file, simply click Tools, Add-ons. This will open a new tab. Look for a gear icon just to the left of the Search all add-ons dialog box on the right side of the display. This will open a pop up menu, select Install Add-on From File, browse to the modified file, and continue with the previous instructions.

An even easier way, after editing and repacking the files, you can simply drag and drop the .xpi files using Explorer or any other file manager tool into Thunderbird, and the installation process will start immediately. Just look out for the confirmation window, it may pop open quickly enough that you don't at first notice it, and it may be obscured by your file manager. This drag and drop method works for both Firefox and Thunderbird, in current versions as of December 2011.

If you have other utilities in your toolbox that you are comfortable using, you can make the whole process even easier. If you use a file manager like the freeware Free Commander or shareware Total Commander that has built in support for zip and other archive files, after renaming the .xpi file you can simply double click it which will open it as if it is a folder on disk. Once inside it you will be able to see all the supporting files and folder structures. Total Commander allows automatic repacking of edited files back into a zip file, Free Commander is not quite as flexible. Simply point at the install.rdf, and press whatever the function key (F4 in Free Commander and Total Commander) or click the menu item that opens the selected file in your default text editor. Make the changes, and for Total Commander, save the file, and go back up out of the virtual folder used to display the zip file contents. The modified version of the install.rdf will be automatically packed right back into the zip file for you. For Free Commander, save the file to a different location, e.g. C:\Temp, and then use Free Commander to copy the file back into the virtual archive folder which will repack it in.

As I said, problems are rare, however you don't know everything the programmer did when writing the addon, so monitor everything carefully until you are sure everything is functioning as it should. There may be specific features in different releases of Firefox or Thunderbird being used by the addon programmer which might really make the addon incompatible with a newer release. In general, unless there is a major change, most things should be safe, because addons for example that "mess" with cookies, such as CookieCuller, are simply changing cookie files where the format does not generally change. The real point is, be careful, and keep backups so that you don't have any reason to curse yourself for making the change, and me for telling you how to do it.

Allan Marillier, original article date August 2008

Updated September 2011 for Thunder bird 7 install procedure

Updated December 23rd, 2011 - Thunderbird allows drag and drop of hacked addon files

Updated December 27th, 2011 with a paragraph about Mozilla's Add-on Compatibility Reporter

Share this
Average: 4.2 (27 votes)
Your rating: None


by bully1963 (not verified) on 6. September 2012 - 3:45  (98848)

Okay followed the instructions firstly trying the version an older of firefox, than the one, I modified "yes popups" for, didn't work :(

I then altered tha version to *.*, that didn't work either.

This is using version firefox 13.0.1.

by bully1963 (not verified) on 6. September 2012 - 3:50  (98851)

oops sorry about the multiple posts, it didn't appear as thought the page was saving

by Bertie (not verified) on 6. May 2012 - 14:42  (93119)

Thanks for this - I remembered it from some time ago but only just needed it today!

by josephj (not verified) on 24. February 2012 - 2:43  (89330)

Very helpful! Thanks.

by stepsoe'sson (not verified) on 28. December 2011 - 16:17  (86127)

Will this work for Roboform v6 which will not work with Firefox versions 5 and later?

by amarillier on 28. December 2011 - 21:34  (86139)

Sorry, I have no idea - I don't use Roboform. Give it a try, all it will take is a few minutes of your time. Why not just update to the most recent version of Roboform? Using the latest add-ons is always best, hacking precious versions should generally only be a last resort if an updated add-on does not yet exist for a new version of any Mozilla app, or if you're living on the leading edge of beta releases, or nightly development builds.

by Luvntravln on 28. December 2011 - 0:00  (86098)

In W7, the profile is located in

your name > AppData > Local > Mozilla > Firefox > Profiles

by Topper (not verified) on 27. December 2011 - 13:52  (86070)

Much much easier and proper way is to use this add-on
With it you can enable again disabled "incompatible" add-on and test it how will work.
After that can report it to Mozilla site like fully working or truly not compatible :)

by amarillier on 27. December 2011 - 17:49  (86080)

True - easier, and "proper" only if you fit into the class of users Mozilla highlight as "Note: Recommended for alpha and beta users only!"

Also true if you don't mind installing yet another add-on. I don't want the overhead of yet another add-on to use up more memory and CPU cycles, I want as few add-ons as possible. Firefox has become bloated enough as it is, and the few add-ons I have installed are only there because I really find them useful.

Aside from all this, I first wrote these instructions in August 2008. Version 0.1 of the Add-on Compatibility Reporter was released in October 2009, ten months later. Some people may like to use the add-on which has been mentioned previously, others may prefer to use my method and eliminate yet another add-on.

"Proper" is entirely relative, and subjective.

by amarillier on 23. December 2011 - 15:13  (85813)

An even easier way I just discovered today (added to the main text as well) when Thunderbird updated and my Web-Mail and provider addons stopped working - after editing and repacking the files, you can simply drag and drop the .xpi files using Explorer or any other file manager tool into Thunderbird, and the installation process will start immediately. Just look out for the confirmation window, it may pop open quickly enough that you don't at first notice it, and it may be obscured by your file manager.

by Suze (not verified) on 2. October 2011 - 13:37  (80743)

I too had a bad experience updating thunderbird to Version 6.0.
Lost a bunch of addons and it was really really slow. Is version 7.0 any better? With this hack in hand I might consider upgrading again.

by eikelein on 3. October 2011 - 2:35  (80785)

7 is okay - but I have only three add-ons.

Adblock Plus was by TB 7 automatically updated to 1.3.10 although the addons.mozilla... site and the developer listed 1.3.9 as the latest version; go figure.

Compact Header and
Extra Folder Columns were compatible.

I had tried the hack with Adblock Plus but immediately got an error telling me that it was not correct. So W. Palant (the author) has a hash test in there against manipulation; sad if you don't have it running with all the advertisement garbage currently being distributed.

by amarillier on 2. October 2011 - 21:32  (80771)

7 seems to work well. I have not had any problems with it and performance seems reasonable.

by antheads (not verified) on 29. September 2011 - 18:15  (80574)

or one could just use the addon compability reporter which allows you to use addons past their version numbe compability

by natep on 29. September 2011 - 13:33  (80570)

what about MAC ?

by amarillier on 30. September 2011 - 20:50  (80655)

Sorry, I don't have access to a Mac so I can't tell you, but I would guess that the add-on mechanism is almost identical between different operating systems.

by click-click (not verified) on 29. September 2011 - 10:27  (80562)

Your solution to updating install.rdf will not work on plugins that check the hash of the install.rdf to see if it has been tampered with.
I have an online banking plugin that does this and updating maxVersion will result in a msg that the installation cannot continue due to file corruption.

by amarillier on 30. September 2011 - 21:04  (80657)

True, and in that case you're at the mercy of the add-on developer, but I would guess that the majority of add-ons are not in the same situation.

I have never had the problem yet and I've used the trick for many years. The warnings still stand though, hacking a version number or using yet another add-on like Add-on Compatibility Reporter may cause some strange behavior if the add-on is totally incompatible with the latest version of Firefox or Thunderbird.

by J_L on 29. September 2011 - 1:21  (80533)

There are easier and better ways to do this (at least for Firefox):

by amarillier on 30. September 2011 - 21:00  (80656)

Thanks for the link, that's worth others looking at as well. Easier and better are debatable though. I would not want to go start turning compatibility checks off - I would rather stay totally in control and if I need to, simply edit one or two files myself and hack the version number, that way I know exactly what I have messed with, and don;t over-ride a setting that potentially affects other add-ons.

I definitely don't want to install yet another add-on to do it for me though. The less add-ons the better, because the more you have, the more memory and CPU cycles are used, and the longer Firefox takes to start up.

At the end of the day though, "to each his own", and what's best for me is not necessarily best for you and others, and that is ok. Having options is good and we can all use what we are comfortable with.

by Ultimate on 29. September 2011 - 13:13  (80569)

Both for Firefox and Thunderbird, I used to use the nightly tester tool, but now I just use the Add-on comptability reporter, which is official from mozilla.

by David Goldsmith (not verified) on 28. September 2011 - 11:51  (80504)

The last step "Install using File, Open" doesn't seem to work under Thunderbird 7. The only File->Open options are Saved Message and Calendar file.

Under Tools->Add-ons I don't see an option for specifying a local file anymore. I downloaded the extension I want from, edited the .xpi file and changed the max version number in the .rdf file, but I'm missing a means to install the modified .xpi file.

by amarillier on 29. September 2011 - 0:51  (80532)

With Thunderbird 7 the process has changed slightly but is still just as easy. Instead of File, Open File and selecting the modified .xpi file, simply click Tools, Add-ons. This will open a new tab. Look for a gear icon just to the left of the Search all add-ons dialog box on the right side of the display. This will open a pop up menu, select Install Add-on From File, browse to the modified file, and continue with the previous instructions.

I will see if I can edit the original article to add this for those moving to newer versions of Thunderbird.

by ssoundman on 29. September 2011 - 15:11  (80571)

Thanks so much, amarillier! Your process worked great for Thunderbird 6.0.2 using the 9.0 suggestion.

I've been avoiding the upgrade to Thunderbird 7 because I lost the functionality of my favorite toolbar buttons at the previous upgrade to version 6. So I swore off being on the bleeding edge of Mozilla updates when possible.

But your method worked for Thunderbird 6.0.2; and I just updated to version 7.0 and my toolbar buttons still work - HOORAY!


by tseliso (not verified) on 29. August 2011 - 7:46  (78537)

Thanks bro, this has been very handy after upgrading to Thunderbird 6 and loosing one add-on which I depended on so much

by amarillier on 30. August 2011 - 1:16  (78599)

You're welcome. I still use it sometimes myself.

The previous comment by Anonymous is correct, if you use 7Zip, NotePad++, Total Commander, or some other utilities you don't need to rename or unpack any file. They do make it easier - if you already know how to use those tools. Much easier. My point in giving the detail the way I did was to make the instructions absolutely generic so anyone with any archive utility and editor could do the necessary tweaking.

Another previous comment about simply putting in * for the version is also correct, I have done that too, the reason I put in some strange number, like 9.0 is that it makes it more obvious that it is a version I have tweaked, so in future I know if I have a hacked, or original installer archive. Maybe not relevant to some people - and I do keep copies and rename, but a 9.0 stands out much more than an * does.

by Anonymous on 7. January 2010 - 16:03  (40481)

If 7-Zip is used to open (Open Archive) the .xpi addon file, the extension will not need to be modified prior to editting the install.rdf file. Also the install.rdf file will not have to be extracted and then re-packed into the .xpi file as the install.rdf file can be edited directly from the 7-Zip menu display. Just save the modifications to the install.rdf file prior to quitting 7-Zip and select "OK" when presented with the "Do you want to update it in the archive?" query.

If Notepad++ is installed on your system, you can go to the Options menu in 7-Zip (after opening addon) and set the default editor to Notepad++, then the install.rdf file will appear as a properly formatted and readable file and therefore will be easier to modify.

by Anonymous on 15. August 2009 - 16:09  (27165)

You can set the max version to *
It should never go out of date

Gizmos Needs You

Gizmo's Freeware is Recruiting

 We are looking for people with skills or interest in the following areas:
 -  Mobile Platform App Reviews for Android and iOS
 -  Windows, Mac and Linux software reviews       Interested? Click here