updating.md

Updating Instructions

Updating from the Control Panel

When an update is available, users with the permission to update Craft will see a badge in the CP next to the Utilities navigation item in the sidebar. Click on Utilities and then choose Updates. You can also use the Updates widget on the Control Panel dashboard, which is installed by default.

This section displays both Craft CMS updates and plugin updates. Each update has its own Update button. Clicking that will initiate Craft’s self-updating process.

You can run all of the updates (Craft, all plugin updates available) using the Update All button at the top left of the Updates page.

::: tip Craft’s changelog will warn you of any critical changes at the top of the release notes. While there aren’t usually any warnings, it’s always a good idea to check before updating. :::

Updating from the Terminal

Craft 3.0.38 and 3.1.4 introduced a new update console command that can be used to update Craft and plugins.

To see available updates, go to your Craft project in your terminal and run this command:

./craft update

To update everything all at once, run this command:

./craft update all

To update a specific thing, replace all with its handle (either craft to update Craft, or a plugin’s handle).

./craft update element-api

You can also pass multiple handles in at once:

./craft update element-api commerce

By default, Craft will update you to the latest available version. To update to a specific version, append :<version> to the handle:

./craft update element-api:2.5.4

Craft also provides an update/composer-install command, which behaves like the composer install command, but doesn’t require you to have Composer installed.