Submit your Add-on to the site

Hosting your Add-on

The Pale Moon Add-ons Site hosts the following add-on types:

  • Extensions
    • Toolkit (Overlay)
    • Toolkit (Bootstrap)
    • PMKit (modified for Pale Moon Jetpack/SDK-style)
  • Themes (Complete themes)

The service will provide full hosting of your add-on, a dedicated page, and automatic update services.

You should submit a request to the Add-ons Team (via the forum's PM system) with the following information:

  • A 64x64 alpha transparent icon in the PNG format (we can use the generic green puzzle piece if you simply don't have one)
  • A slug version of your extensions name to be used for internal identification and URL generation (For example, a name of 'My Add-on' would become 'my-add-on' -- it is meant to be unique). Only lower case letters (a-z), numbers (0-9) and dashes (-) are permitted here.
  • Category to be listed on (only one per add-on is allowed at this time; additionally, themes do not use categories): see the full list here.
  • Long Description for the actual add-on's page (if applicable otherwise Short Description will be used)
  • The Initial XPI for review and initial setup
  • A user name for FTP access so that you can update your add-on later. We will assign you a lengthy (25 chars or so) random alpha-numeric password which will be promptly forgotten by us.

Optionally, you could also provide the following, to be shown on the add-on listing:

  • Author Name (as you want it on the page) - this uses the 'creator' tag in install.rdf if available, else this is used.
  • Short Description for the category listing (~200 character limit) - this uses the 'description' tag in install.rdf if none is provided here.
  • License - both OSI-approved licenses and custom licenses are allowed here. If a license is not provided, a default copyright notice is shown instead.
  • Code repository URL (e.g. GitHub repo)
  • Homepage URL - this uses the 'homepageURL' tag in install.rdf if available, else this is used.
  • Support URL
  • Support email address
  • Preview image - note that currently only one preview image can be shown for each listing

Please note that the add-on name is read from your add-on's install.rdf, so please take this into consideration when submitting.

NOTE: Please do not use the "em:updateURL" in your install.rdf. If you want to use this you should choose the next option.

Indexing your Add-on

This is known informally as an External. Indexing is available to both extensions and themes will list your extension to the category of your choosing and will link to where users can obtain your extension.

This solution is a great choice for maintaining your independence and choice of infrastructure and distribution. You may, for example, want to host your extension on your own website or source code repository's downloads section.

For the Add-ons Manager's Automatic Update Service you must include in your install.rdf file an "em:updateURL" tag to a well formed xml (rdf) file on your own service. You must also take into account that you must not set any cache headers on XPI files if you use HTTPS because cached items do not contain the original security information and will cause issues and therefore will be rejected by the XPInstall routine as insecure.

You should submit a request to the Add-ons Team (via the forum's Private Message system) with the following information:

  • Add-ons Name
  • A 64x64 alpha transparent icon in the PNG format (we can use the generic green puzzle piece if you simply don't have one)
  • Short Description for the category listing (~240 character limit)
  • Category to be listed on (only one per add-on is allowed at this time; additionally, themes do not use categories): see the full list here.
  • URL to where you host your add-on

In this instance we would not be able to display a Long Description, any preview images or any other metadata. It is up to you to provide these on the page you want us to link to in the category listing.

NOTE: For those of you who wish to use AMO (Mozilla's Add-ons Site) you may do this and we will index it but issues at AMO have been identified that have caused problems in the past with updates and one instance of a mass issue affecting all updates from AMO to Pale Moon. We CANNOT accept indexing on AMO for add-ons which would not otherwise support the corresponding Firefox versions we advertise as (24.9 for Pale Moon 25.x/26.x; 27.9 for Pale Moon 27.x); such add-ons must either self-host or host with us.

Additionally, it is expected that eventually Mozilla's service will become unusable for purposes of providing updates to Firefox add-ons for Pale Moon users as they change how their service works. At any time we may discontinue sending unknown (to the Pale Moon Add-ons Site) update requests to Mozilla's Add-ons Site.

At this time the Pale Moon Add-ons Team considers Mozilla's Add-ons Site and services to be legacy at best.

Categories: Add-ons
Firefox, Mozilla Firefox and Mozilla are registered trademarks of the Mozilla Corporation.
Site design and Branding © 2016 Moonchild Productions - All rights reserved
Any other content is copyright or trademark to their respective owners.
This site uses Cookies - Your usage indicates your consent to their use.

The Pale Moon Developer Wiki is powered by Enano