What's the pre-releases channel, and how do I enable it?

We use the pre-releases channel to make updates available in our package provider which we don't yet consider stable. For example there may be new features or changes that may affect existing installations that we're looking to slowly release into the world.

By opting in to the pre-releases channel, you can instruct our package provider to either give you the latest stable release, or the latest release even if it's a release candidate or dev build. The level of instability on the pre-releases channel can differ from extra to extra, and from release to release. If you'd like to know how unstable we consider a certain update to be, please send us an email at [email protected].

While we're always careful with every change that makes it into a release, even a pre-release, the general recommendation is to only use pre-releases on development or staging environments.

To install a pre-release extra, follow these steps.

1. If you don't already have the package provider setup with an API Key, login and create an API Key in your account. Find the API Key you created and, if you haven't already, add our package provider to your MODX site per the instructions on the page or here.
2. Find your api key in the list and click on "Pre-releases" in the channels column. When the page reloads, you should see a checkmark in front of the "Pre-releases". If you're already using an API Key, you don't have to create a new one, you can just enable the channel.
3. Now check for updates or browse our package provider, you'll see the pre-release version offered as well.