1. Resources
  2. Version numbers


Version numbers

Learn what version numbers mean for your site.

Nova releases are guided by a principle known as semantic versioning. The goal of semantic versioning is to ensure that users know what to expect when a new version of software is released based solely on the version number itself.

A version number is typically going to be in the format of X.X.X. Let's look at the first number and start there, but for all of these we'll be using the example of 3.1.7 so we have a consistent example to use as we go over each piece of the version number.

First Number - 3.1.7 (Major Updates)

The first number is going to refer to which MAJOR version the software is on. This number only changes when there has been a huge, potentially project-breaking update. Generally speaking, we've only updated the major version when making architectural changes to Nova.

The goal with any major update to Nova is to ensure we're able to migrate as much of your data from one version to the next. However, with major versions, some data may not be able to be migrated due to the nature of the changes that are being introduced.

Second Number - 3.1.7 (Minor Updates)

There will be times where we want to add new features to Nova, and maybe they're not even all that groundbreaking. Maybe we're consolidating a few functions to make things more lightweight. Either way, this is a small change that isn't quite enough to merit a full version update. So instead, we bump up the second number. It's a way to let people know that "Hey, this isn't a full-on overhaul, but there is some neat stuff being added that you may like". So even though it may not seem as important as a true version update, it's still important to make sure you update Nova.

As with all our updates, we aim to include scripts to migrate data to the new version. Minor version migrations should be quick and straightforward and there should be minimal impact to the data on your site.

The Last Number - 3.1.7 (Patch Updates)

This is the smallest, but some may argue the most important aspect of version numbers. The last number represents patches. This commonly means that some bugs have been fixed, which can be anything from a super-trivial issue to something as big as a security fix. These often carry the most weight, at least from a certain point of view, and should definitely be updated as soon as possible. Out of date software is never a good thing.

But that's mostly it for the numbers, save for one other thing. Notice the last number is a 14, having two digits instead of one. Just because one update is 7.2.9, doesn't mean the next one is going to be 7.3.1. As long as it's just patches being made, the bottom number will continue to increase until new features are added to merit an increase of the "Minor" version.

As with all of our updates, we aim to include scripts to migrate data to the new version. In most cases, patch versions will not require any data migration.

What version of Nova am I running?

If you're curious what version of Nova your site is running, you can find out by navigating to the System & Versions page which can be found at the bottom of the admin control panel navigation sidebar.

In that page, you'll be shown what version of Nova your files are running, what version your database is running, what version of Laravel is being used, what version of PHP your server is running, and several configuration variables such as your default theme and email driver.

system versions