Updates are handled by Composer, PHP's dependency manager. We recommend running all updates locally (not on production) via the command line.

Best Practice

We recommend running all updates locally to eliminate downtime and any possibility of an unexpected change or timeout affecting your site.


If you installed with Composer, you can update your installation with the following command:

composer update statamic/cms --with-dependencies

Note: You may prefer to run composer update to update all of your dependencies.

Statamic CLI

If you installed with Statamic CLI, you can update your installation with the following command:

statamic update

Control Panel

The Control Panel will inform you when updates are available.

From within the Tools → Updates section, Statamic will provide you with the appropriate Composer commands to run.

If you choose to install a non-latest version, your statamic/cms Composer version dependency will be fixed to whichever explicit version you choose. To go back to a constraint-style version, you'll need to update your composer.json file.

For example, if you chose v4.0.1 in the control panel, this will be your Composer constraint.

"require": {
"statamic/cms": "4.0.1",

To go back to a more traditional version range constraint, you may want to replace it with this:

"require": {
"statamic/cms": "^4.0",

Major Upgrades

Upgrading between major Statamic versions sometimes involves extra manual steps. Check out these guides for further details.

Docs feedback

Submit improvements, related content, or suggestions through Github.

Betterify this page →
Hello there! Are you looking for the Statamic v2 documentation?