### ✅ Prerequisites

Before starting, ensure:

* Your store runs **Magento 2.3.x or higher**.

* You’re comfortable using the **command line**.

* The environment is in **developer mode** (or work on a staging/dev clone before production)

---

### 1. Get the Updated Version

#### 🔁 Via Composer (Recommended)

1. Ensure you've configured your private repository/authentication as in this [configuration](https://support.bird.eu/hc/extensions/articles/1751374657-generate-your-access-keys) guide.

2. Run:

   ```
   composer update blackbird/module-extension-name
   ```

   Replace `module-extension-name` with the correct package identifier (e.g. `blackbird/monetico`).

#### 🗜️ Manual ZIP Upgrade

1. Download the **new version ZIP** from your Bird customer account.

2. **Overwrite** the existing folder at:

   ```
   app/code/Blackbird/ExtensionName
   ```

   maintaining correct structure (`registration.php`, etc.).

3. Ensure any dependencies listed under `require` (e.g., `blackbird/extensions-core`) are also updated accordingly.

---

### 2. Enable & Reinstall Module

Once the updated code is in place, from your Magento root:

```
bin/magento setup:upgrade
```

*Note*: If new dependencies or code changes were introduced:

```
bin/magento setup:di:compile 
bin/magento setup:static-content:deploy
```

Replace `Blackbird_ExtensionName` with your actual module name.

---

### 3. Clear & Refresh Caches

Run to prevent stale code:

```
bin/magento cache:clean bin/magento cache:flush
```

Confidence that the update took effect is critical.

---

### 4. Troubleshooting & Support

Monitor logs for any errors:

```
var/log/system.log
var/log/exception.log
```

---

## ✅ Summary

Updating a Blackbird extension is a matter of:

1. Fetching the new version (via Composer or ZIP upload),

2. Re-running Magento’s module enablement and upgrade commands,

3. Clearing caches,

4. Reviewing for errors.

Always run tests in a development environment first and monitor logs after updating.