> ## Documentation Index
> Fetch the complete documentation index at: https://docs.forest.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrade to v6

> The purpose of this note is to help developers to upgrade their agent from v5 to v6. Please read carefully and integrate the following breaking changes to ensure a smooth upgrade.​

## Upgrading to v6

> [!WARNING]
>
> Before upgrading to v6, consider the below **breaking changes**.

> [!WARNING]
>
> As for any dependency upgrade, it's very important to **test this upgrade** **in your testing environments**. Not doing so could result in your admin panel being unusable.

To upgrade to v6, simply run:

> [tab] SQL
>
> ```bash theme={null}
> npm install forest-express-sequelize@^6.0.0
> ```

> [tab] Mongoose
>
> ```bash theme={null}
> npm install forest-express-mongoose@^6.0.0
> ```

> [!NOTE]
>
> In case of a regression introduced in Production after the upgrade, a rollback to your previous agent is the fastest way to restore your admin panel.

## Breaking changes

### Agent initialization

The agent initialization now **returns a promise**. This solves an issue wherein exposed agents were not yet initialized and thus returning 404s.

You must update the following 2 files:

```javascript theme={null}
// BEFORE
module.exports = function (app) {
  app.use(Liana.init({

// AFTER
module.exports = async function (app) {
  app.use(await Liana.init({
```

```javascript theme={null}
// BEFORE
resolve: Module => new Module(app),

// AFTER
resolve: Module => Module(app),
```

### Select all feature

This version also introduces the new Select all behavior. Once you've updated your **bulk** Smart Actions according to the below changes, you'll be able to choose between selecting **all** the records or only those displayed on the current page.

```javascript theme={null}
// BEFORE
router.post('/actions/mark-as-live', permissionMiddlewareCreator.smartAction(), (req, res) => {
  let companyId = req.body.data.attributes.ids[0];

  return companies
    .update({ status: 'live' }, { where: { id: companyId \}\})
    .then(() => {
      res.send({ success: 'Company is now live!' });
    });
});

// AFTER
import { RecordsGetter } from "forest-express-sequelize";

...

router.post('/actions/mark-as-live', permissionMiddlewareCreator.smartAction(), (req, res) => {
  return new RecordsGetter(companies).getIdsFromRequest(req)
    .then((companyIds) => {
      return companies
        .update({ status: 'live' }, { where: { id: companyIds \}\})
        .then(() => {
          res.send({ success: 'Company is now live!' });
        });
    });
});
```

> [!WARNING]
>
> If you altered the default DELETE behavior by overriding or extending it, you'll have to do so as well with the new [BULK DELETE route](https://docs.forest.app/legacy/javascript-agents/reference-guide/routes/default-routes.md#delete-a-list-of-records).

## Important Notice

### Changelogs

This release note covers only the major changes. To learn more, please refer to the changelogs in our different repositories:

* [Express-sequelize changelog](https://github.com/ForestAdmin/forest-express-sequelize/blob/master/CHANGELOG.md#release-600---2020-03-17)
* [Express-mongoose changelog](https://github.com/ForestAdmin/forest-express-mongoose/blob/master/CHANGELOG.md#release-600---2020-03-17)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.