> For the complete documentation index, see [llms.txt](https://senselab.gitbook.io/senselab-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://senselab.gitbook.io/senselab-docs/vendor/spatie/laravel-multitenancy/changelog.md).

# Changelog

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

## 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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://senselab.gitbook.io/senselab-docs/vendor/spatie/laravel-multitenancy/changelog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.