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 control panel next to Utilities in the global navigation:

Screenshot of control panel cropped to “Utilities” global navigation item, which contains a circular badge with the number “1” in it

Click UtilitiesUpdates. (You can also get to this view directly from the Updates widget that’s installed by default in the control panel dashboard.)

This section displays updates for Craft CMS and installed plugins, where each version has its own collapsible panel detailing relevant changes.

Stylized screenshot of “Updates” page, which displays two plugins with newer versions with collapsible panes detailing their changes

There may be an Update button next to each item and an Update All at the top of the screen, depending on your the allowUpdates and allowAdminChanges settings for your current environment. You can use those to initiate updates directly from the control panel.

Craft’s changelog (opens new window) 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 the changelog and any upgrade guides before updating.

# Updating from the Terminal

The update console command can be used to update Craft and plugins.

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

php craft update

An example interaction with the  command.

To update everything all at once, run this command:

php craft update all

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

php craft update element-api

An example interaction with the  command.

You can also pass multiple handles in at once:

php 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:

php craft update element-api:2.7.0

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

# Upgrade Guides

Sometimes there are significant changes to be aware of, so it’s worth checking the upgrade guide for each version or edition along your upgrade path.