Skip to content

[UPDATE] Autoupgrade documentation for 9.x #2062

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: 9.x
Choose a base branch
from
+43 −15
Open

[UPDATE] Autoupgrade documentation for 9.x #2062

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
829df12
update: documentation to match new recommended version present on ver…
ga-devfront Nov 27, 2025
7bccc47
fix: update image
ga-devfront Nov 27, 2025
224186d
fix: update image
ga-devfront Nov 27, 2025
548cd10
fix: cli array
ga-devfront Nov 27, 2025
4fa1600
fix: cli array
ga-devfront Nov 27, 2025
bb4c2e6
fix: harmonize channel
ga-devfront Nov 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified basics/keeping-up-to-date/update/img/update-assistant-version-choice-page.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
22 changes: 17 additions & 5 deletions basics/keeping-up-to-date/update/update-from-the-back-office.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,13 +54,25 @@ main steps: Version choice > Update options > Backup > Update > Post-update.

### Version choice

The step “Version choice”, shows you the updates available for your store. Two update channels are listed at this stage:

- The official “online” update for your store, detected by PrestaShop APIs (major, minor or patch versions). This update
corresponds to the most recent version of PrestaShop compatible with the PHP version of your server.
- The “local” update, which displays customized updates detected in your `/your-admin-directory/autoupgrade/download`
The step "Version choice", shows you the updates available for your store. Up to three update channels can be listed at this stage:

- The official **"recommended"** update for your store, detected by PrestaShop APIs (major, minor or patch versions). This update
corresponds to the most stable and well-tested version of PrestaShop compatible with the PHP version of your server. The recommended
version is identified by a "Recommended" badge displayed next to the version type badge (major, minor, or patch).
- The **"latest"** update available for your store, which corresponds to the most recent version of PrestaShop compatible with the
PHP version of your server. This version may be shown separately from the recommended version when they differ.
- The **"local"** update, which displays customized updates detected in your `/your-admin-directory/autoupgrade/download`
folder on your server.

#### Understanding recommended versions

The recommended version is the version that has been thoroughly tested and validated for stability. It may not always be the latest
release, but it represents the safest upgrade path for your store. Depending on the current state of PrestaShop releases, you may see:

- Both a **recommended version** and a **latest version** displayed as separate options (when they differ).
- Only one version displayed with a "Recommended" badge (when the recommended version is also the latest).
- Only the latest version without a "Recommended" badge (when no specific version is marked as recommended).

These views are thus adapted to the version of PrestaShop used in your store, to the PHP version of your server, and
therefore reflect possible updates for your store.

Expand Down
36 changes: 26 additions & 10 deletions basics/keeping-up-to-date/update/update-from-the-cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -295,18 +295,34 @@ Example of the `update:check-new-version` command execution:

```text
$ php bin/console update:check-new-version admin123
-----------+----------+-------+---------------------------------------------------------------------------+
| Version | Channel | Type | Information |
+----------+----------+-------+---------------------------------------------------------------------------+
| 8.2.0 | online | minor | https://build.prestashop-project.org/news/2024/prestashop-8-2-0-available/|
| 9.0.0 | local | major | Zip: 2024-10-17-develop-prestashop_9_0_0.zip |
| | | | Xml: prestashop_9.0.0.xml |
| 8.1.0 | local | patch | Zip: 8_1_0.zip |
| | | | Xml: 8.1.0-2.xml, 8.1.0.xml |
+---------+--------------------+-------+--------------------------------------------------------------------------------------+
| Version | Channel | Type | Information |
+---------+--------------------+-------+--------------------------------------------------------------------------------------+
| 8.2.3 | online_recommended | minor | https://build.prestashop-project.org/news/2025/prestashop-8-2-3-security-release/ |
| 9.0.1 | online | major | https://build.prestashop-project.org/news/2025/prestashop-9-0-1-maintenance-release/ |
| 9.0.0 | local | major | Zip: 2024-10-17-develop-prestashop_9_0_0.zip |
| | | | Xml: prestashop_9.0.0.xml |
| 8.1.1 | local | patch | Zip: 8_1_1.zip |
| | | | Xml: 8.1.1-2.xml, 8.1.1.xml |
+---------+--------------------+-------+--------------------------------------------------------------------------------------+
```

- The official “online” update for your store, detected by PrestaShop APIs (major, minor or patch versions). This update corresponds to the most recent version of PrestaShop compatible with the PHP version of your server.
- The “local” update, which displays customized updates detected in your `/your-admin-directory/autoupgrade/download` folder on your server.
#### Understanding the Channel column

The **Channel** column indicates the source and type of the available update:

- **`online_recommended`**: The recommended update for your store, detected by PrestaShop APIs (major, minor or patch versions). This update corresponds to the most stable and well-tested version of PrestaShop compatible with the PHP version of your server. The recommended version represents the safest upgrade path for your store.
- **`online`**: The latest update available for your store, which corresponds to the most recent version of PrestaShop compatible with the PHP version of your server. This version may differ from the recommended version.
- **`local`**: Customized updates detected in your `/your-admin-directory/autoupgrade/download` folder on your server.

#### Update scenarios

Depending on the current state of PrestaShop releases, the command output may show:

- Both a **recommended version** (`online_recommended`) and a **latest version** (`online`) when they differ.
- Only one online version with the `online_recommended` channel when the recommended version is also the latest.
- Only the latest version with the `online` channel when no specific version is marked as recommended.
- Local versions (`local` channel) in addition to online versions, if custom update files are detected on your server.
Copy link
Contributor

@tblivet tblivet Nov 27, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can the channel display be harmonized? Because sometimes we have parentheses and sometimes we don't.


### update:check-requirements command

Expand Down