# Changelog

All notable changes to `laravel-multitenancy` will be documented in this file

## 4.1.1 - 2026-04-12

### What's Changed

* Add description to TenantsArtisanCommand by @dac514 in https://github.com/spatie/laravel-multitenancy/pull/633

### New Contributors

* @dac514 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/633

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/4.1.0...4.1.1

## 4.0.9 - 2026-02-09

### What's Changed

* Fix #617: Add default value for TasksCollection constructor parameter by @freekmurze in https://github.com/spatie/laravel-multitenancy/pull/625
* Fix #620: Handle JobRetryRequested in queue tenant awareness by @freekmurze in https://github.com/spatie/laravel-multitenancy/pull/624

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/4.0.8...4.0.9

## 4.0.8 - 2026-02-09

### What's Changed

* Fix tenant context not being restored when exception occurs in `execute()` by @moisish in https://github.com/spatie/laravel-multitenancy/pull/622
* Bump minimum testbench to ^9.1.4 to fix `$latestResponse` error on prefer-lowest
* Fix notification test assertions for Laravel 11/12 compatibility

### New Contributors

* @moisish made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/622

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/4.0.7...4.0.8

## 4.0.7 - 2025-09-26

### What's Changed

* Fix syntax for tenant aware interface config by @danharrin in https://github.com/spatie/laravel-multitenancy/pull/608

### New Contributors

* @danharrin made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/608

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/4.0.6...4.0.7

## 4.0.6 - 2025-09-26

### What's Changed

* Command state persistence with `TenantAware` by @SethSharp in https://github.com/spatie/laravel-multitenancy/pull/602
* Add types to TenantCollection by @markieo1 in https://github.com/spatie/laravel-multitenancy/pull/596
* Update issue template by @AlexVanderbist in https://github.com/spatie/laravel-multitenancy/pull/603
* feat: Add configuration option to specify `TenantAware` and `NotTenantAware` interfaces by @przemyslaw-przylucki in https://github.com/spatie/laravel-multitenancy/pull/607

### New Contributors

* @SethSharp made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/602
* @markieo1 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/596
* @przemyslaw-przylucki made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/607

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/4.0.5...4.0.6

## 4.0.5 - 2025-05-12

### What's Changed

* Update using-multiple-databases.md by @najbo in https://github.com/spatie/laravel-multitenancy/pull/584
* [Bugfix]: Jobs with `ShouldBeEncrypted` need to be decrypted by @Joel-Jensen in https://github.com/spatie/laravel-multitenancy/pull/588

### New Contributors

* @najbo made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/584
* @Joel-Jensen made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/588

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/4.0.4...4.0.5

## 4.0.4 - 2025-02-20

### What's Changed

* Laravel 12.x Compatibility by @laravel-shift in https://github.com/spatie/laravel-multitenancy/pull/580

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/4.0.3...4.0.4

## 4.0.3 - 2024-12-22

### What's Changed

* Docs: Fix formatting in interface code block by @inmanturbo in https://github.com/spatie/laravel-multitenancy/pull/560
* Show name of the job in the Exception by @michaelnabil230 in https://github.com/spatie/laravel-multitenancy/pull/570

### New Contributors

* @michaelnabil230 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/570

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/4.0.2...4.0.3

## 4.0.2 - 2024-08-23

### What's Changed

* Update using-a-custom-tenant-model.md by @thoresuenert in https://github.com/spatie/laravel-multitenancy/pull/553
* Fix an exception when requiring a tenant to be active to unserialize a model

### New Contributors

* @thoresuenert made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/553

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/4.0.1...4.0.2

## 4.0.1 - 2024-08-19

* Fix NotTenantAware notifications, mailables, closures, listeners & broadcast events in a default tenant aware application

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/4.0.0...4.0.1

## 4.0.0 - 2024-07-24

### What's Changed

* Refactor registerTenantFinder method to reduce complexity by @misaf in https://github.com/spatie/laravel-multitenancy/pull/536
* Contract IsTenant replace Tenant uses by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/544

### New Contributors

* @misaf made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/536

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/3.2.0...4.0.0

## 3.2.0 - 2024-03-12

### What's Changed

* Laravel 11.x Compatibility by @laravel-shift in https://github.com/spatie/laravel-multitenancy/pull/522

### New Contributors

* @laravel-shift made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/522

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/3.1.1...3.2.0

## 3.1.1 - 2024-01-09

### What's Changed

* Update migration stub by @sevannerse in https://github.com/spatie/laravel-multitenancy/pull/495
* Correct Typos by @jacobmllr95 in https://github.com/spatie/laravel-multitenancy/pull/501
* Add new `TenantNotFoundForRequestEvent` by @jacobmllr95 in https://github.com/spatie/laravel-multitenancy/pull/502

### New Contributors

* @sevannerse made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/495
* @jacobmllr95 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/501

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/3.1.0...3.1.1

## 3.1.0 - 2023-09-27

### What's Changed

- Add support to queued closures by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/492

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/3.0.3...3.1.0

## 3.0.3 - 2023-06-30

### What's Changed

- [no ci] Fix typo in config comment by @inmanturbo in https://github.com/spatie/laravel-multitenancy/pull/454
- [FIX] unmatched double quote (typo) by @inmanturbo in https://github.com/spatie/laravel-multitenancy/pull/459
- [FIX] Bind or forget current tenant by @raymadrona in https://github.com/spatie/laravel-multitenancy/pull/471

### New Contributors

- @inmanturbo made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/454
- @raymadrona made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/471

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/3.0.2...3.0.3

## 3.0.2 - 2023-02-09

### What's Changed

- Fresh Tenant on each job by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/438

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/3.0.1...3.0.2

## 3.0.1 - 2023-02-03

### What's Changed

- Correct doc url version for v3 by @l3aro in https://github.com/spatie/laravel-multitenancy/pull/412
- docs: update composer command for install by @alexrififi in https://github.com/spatie/laravel-multitenancy/pull/413
- Add PHP 8.2 Support by @patinthehat in https://github.com/spatie/laravel-multitenancy/pull/424
- Update broken shield badge by @erikn69 in https://github.com/spatie/laravel-multitenancy/pull/437
- Laravel 10.x Support by @erikn69 in https://github.com/spatie/laravel-multitenancy/pull/435

### New Contributors

- @l3aro made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/412
- @patinthehat made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/424
- @erikn69 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/437

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/3.0.0...3.0.1

## 3.0.0 - 2022-10-28

### Breaking change

- `NotTenantAware` jobs will now forget any current tenant that might have been set when starting processing.

## 2.3.9 - 2022-10-30

- Fix an issue where the `Illuminate\Cache\Repository` was not being cleared from the container

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/2.3.8...2.3.9

## 2.3.8 - 2022-09-08

### What's Changed

- Replace id with getKey() so uuids could be used as primary keys by @lartisan in https://github.com/spatie/laravel-multitenancy/pull/392

### New Contributors

- @lartisan made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/392

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/2.3.7...2.3.8

## 2.3.7 - 2022-07-01

### What's Changed

- Prefix Cache Task - Cache Store by @moisish in https://github.com/spatie/laravel-multitenancy/pull/374

### New Contributors

- @moisish made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/374

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/2.3.6...2.3.7

## 2.3.6 - 2022-05-17

## What's Changed

- Docs: fix the link to the video introduction by @PovilasKorop in https://github.com/spatie/laravel-multitenancy/pull/361
- Change return type hint for `Tenant` class from `self` to `static` by @ksassnowski in https://github.com/spatie/laravel-multitenancy/pull/365

## New Contributors

- @PovilasKorop made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/361
- @ksassnowski made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/365

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/2.3.5...2.3.6

## 2.3.5 - 2022-04-08

## What's Changed

- Refresh connection resolver for models after switching database by @AlexVanderbist in https://github.com/spatie/laravel-multitenancy/pull/355
- Fix cache prefixes not being updated by @AlexVanderbist in https://github.com/spatie/laravel-multitenancy/pull/355
- Better compatibility with Octane

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/2.3.4...2.3.5

## 2.3.4 - 2022-03-30

## What's Changed

- Remove link to filesystem doc that doesn't exist by @skoontastic in https://github.com/spatie/laravel-multitenancy/pull/349
- Fix migration tests by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/352
- Improves the SwitchRouteCacheTask by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/351

## New Contributors

- @skoontastic made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/349

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/2.3.3...2.4.0

## 2.3.3 - 2022-02-28

- docs: change method visibility in example by @medvinator in https://github.com/spatie/laravel-multitenancy/pull/326
- added ; in the php code by @MJunaidAhmad in https://github.com/spatie/laravel-multitenancy/pull/329
- Removing typehint for compatibility by @telkins in https://github.com/spatie/laravel-multitenancy/pull/336

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/2.3.2...2.3.3

## 2.3.2 - 2022-01-19

- add support for Laravel 9

## 2.3.1 - 2021-11-29

- Reload Router instance when switching route cache on Laravel Octane by @AlexVanderbist in https://github.com/spatie/laravel-multitenancy/pull/309

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/2.3.0...2.3.1

## 2.3.0 - 2021-11-26

- Add route cache path switcher by @AlexVanderbist in https://github.com/spatie/laravel-multitenancy/pull/308

**Full Changelog**: https://github.com/spatie/laravel-multitenancy/compare/2.2.0...2.3.0

## 2.2.0 - 2021-10-26

- Handle JobRetryRequested queue event and fix (#259)
- 🐛 tenants:artisan backslashes (#296)

## 2.1.1 - 2021-08-18

- add filterCurrent and rejectCurrent to TenantCollection (#275)

## 2.1.0 - 2021-05-04

- add Laravel Octane support

## 2.0.0 - 2021-03-12

- drop support for PHP 7

## 1.6.11 - 2020-12-17

- allow PHP 8

## 1.6.10 - 2020-12-03

- NeedsTenant ability to return or redirect

## 1.6.9 - 2020-09-27

- fix for BroadcastEvent (#142)

## 1.6.8 - 2020-09-24

- add ability to dispatch events tenant aware

## 1.6.7 - 2020-09-07

- add support for Laravel 8

## 1.6.6 - 2020-08-24

- restored check isCurrent from makeCurrent

## 1.6.5 - 2020-08-21

- 🐛 removed check isCurrent from makeCurrent

## 1.6.4 - 2020-08-11

- forget current when making new tenant current

## 1.6.3 - 2020-08-07

- removed $guarded from Tenant model

## 1.6.2 - 2020-08-07

- TenantAware now uses the Tenant model from config

## 1.6.1 - 2020-08-06

- TenantsArtisanCommand now uses TenantAware trait

## 1.6.0 - 2020-08-06

- added `TenantAware`

## 1.5.1 - 2020-07-30

- 🐛 properly handle queued mailables and notification (#78)

## 1.5.0 - 2020-07-23

- database switch fails with misconfigured tenant (#92)

## 1.4.0 - 2020-07-02

- added `execute` for the landlord

## 1.3.0 - 2020-06-25

- added `$tenant->execute($callable)` to execute isolated tenant code (#60)

## 1.2.0 - 2020-06-21

- `tenant:artisan` search field customizable using config (#52)

## 1.1.5 - 2020-06-21

- allow mass assignment when creating a new tenant by default (#57)

## 1.1.4 - 2020-06-17

- improve error handling of tenant aware jobs

## 1.1.3 - 2020-06-01

- always register the tenants artisan command, so it may be called from web requests as well.

## 1.1.2 - 2020-05-24

- remove unused import from config (#20)

## 1.1.1 - 2020-05-21

- use the configured tenant model in artisan command (#17)

## 1.1.0 - 2020-05-18

- fix published migration name
- ask for artisan command if none is given

## 1.0.0 - 2020-05-16

- initial release
