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

# Upgrading from v4.x to v5.0

## Overview

<Warning>Please don't upgrade multiple versions at once (eg. from v3 to v5). Please upgrade one step at a time.</Warning>

To get started with the upgrade process, follow the below steps:

**1.** In your `composer.json` file, update the `doublethreedigital/runway` version constraint:

```json theme={null}
"doublethreedigital/runway": "^5.0"
```

**2.** Then run:

```
composer update doublethreedigital/runway --with-dependencies
```

**3.** You may also want to clear your route & view caches:

```
php artisan route:clear
php artisan view:clear
```

**4.** Update complete!

**Please test locally before deploying to production!**

## Changes

### High: Add `HasRunwayResource` trait to Eloquent models

You will need to add a new `HasRunwayResource` trait to all Eloquent models configured in the Runway config:

```php theme={null}
// app/Models/Order.php

use StatamicRadPack\Runway\Traits\HasRunwayResource;

class Order extends Model
{
    use HasRunwayResource;
}
```

***

[You may also view a diff of changes between v4.x and v5.0](https://github.com/statamic-rad-pack/runway/compare/4.x...5.x)