NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #770 most downloaded on Packagist
Automatic multi-tenancy for your Laravel application.
Latest stable
v3.10.1
Last release 3 months ago
05 Aug 2026
Release timing varies
gaps range from 8 days to 12 months
Nearly every release is documented
notes for 56 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
94 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Added support for multiple migration paths #268
Patch release.
Per semver, this technically should have been 2.3.0 due to the added feature, but I'm keeping the MINOR version for releases with a lot of features
Fixed You cannot serialize or unserialize PDO instances error when queuing tenant creation on MySQL and PostgreSQL #273
Patch release.
You cannot serialize or unserialize PDO instances error when queuing tenant creation on MySQL and PostgreSQL #273$tenant->persisted is set to true before tenant.created is executed #271
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Patch release.
$tenant->persisted is set to true before tenant.created is executed #271Fix issue related to closure middleware #256
Patch release.
Added support for custom migration parameters #243
Per semver, this technically should have been 2.3.0 due to the added feature, but I'm keeping the MINOR version for releases with a lot of features
Remove typehints in tenant_route() for arguments passed to route() #241
Patch release.
tenant_route() for arguments passed to route() #241tenant_route() helper to generate routes for a specific domain. Useful for testing. #229
tenant_route() helper to generate routes for a specific domain. Useful for testing. #229stancl.tenancy.asset route's path parameter is now correctly marked as optional #240Per semver, this technically should have been 2.3.0 due to the added feature, but I'm keeping the MINOR version for releases with a lot of features
Move facade/ignition-contracts dependency to require
facade/ignition-contracts dependency to requireConflicting routes - you may now use the same URLs in the tenant & central parts of the app docs
Auth::routes() or Nova routes) for both the tenant & central part of the app docscreated_at/updated_at/deleted_at timestampsTenantAwareCommand trait for commands docstenancy() & tenant())tenants:migrate now accepts --pathDon't purge central connections - fix issue caused by writing a regression test #192
Don't purge central connections #189
Breaking change: The queue_automatic_migration configuration key was dropped. Whether post-creation migrations & seeding should be queued now depends…
$tenant->run() -- run a closure inside a tenant's environment Documentationutf8mb & utf8mb4_unicode_ciWhen both DB creation & migration were queued (after tenant creation), a race condition could happen, i.e. the migrate job would be executed before the create DB job.
Breaking change: The queue_automatic_migration configuration key was dropped. Whether post-creation migrations & seeding should be queued now depends on whether the DB creation is queued.
InitializeTenancy middlewareThe InitializeTenancy middleware was part of the route middleware stack, which means it was executed after controller constructors. This could result in problems when a dependency (constructor argument) was injected before tenancy was initialized.
The InitializeTenancy middleware is now executed as part of the global middleware stack. That stack doesn't know whether the current route is a tenant route or a central route, it only knows if the current domain is a tenant domain. If tenancy was initialized on a non-tenant route (= if a central route was visited on a tenant domain), the PreventAccessFromTenantDomains middleware aborts the request.
Breaking change: If you applied the InitializeTenancy middleware on some routes manually, change it to 'tenancy' -- a middleware group. The PreventAccessFromTenantDomains middleware uses the presence of that middleware group as a check for whether a route is marked as tenant or not.
Use Config\Repository contract instead of concrete #157
Config\Repository contract instead of concrete #157tenancy.tenant_route_namespace config in the route SP #161Tenant objects are now used, instead of arrays, to represent tenants. See the Tenants page.
Tenant objects are now used, instead of arrays, to represent tenants. See the Tenants page.domains table is used by the DB storage driver.uuid property on tenants is now id.tenancy() helper now returns an instance of TenantManager while the tenant() helper returns an instance of the current Tenant. If no Tenant has been identified, null is returned. Same with the Tenancy and Tenant facades.Tenancy::eventListener('bootstrapping', function () {})DatabaseTenancyBootstrapper, CacheTenancyBootstrapper etc.Features was introduced. They're classes that provide additional functionality - functionality that is not necessary to bootstrap tenancy.php artisan vendor:publish --provider='Stancl\Tenancy\TenancyServiceProvider' --tag=config
uuid column in the tenants table was renamed to id. The domain column was dropped.domains table. The old migration was renamed, so if you publish migrations again, be sure to delete the old migration, to avoid creating the table twice.
You can publish migrations like this:php artisan vendor:publish --provider='Stancl\Tenancy\TenancyServiceProvider' --tag=migrations
uuid keys are now id.domain key was dropped._tenancy_domains key is used to store an array of domains that belong to the tenant.Bug fixes, config was restructured, tenants:migrate-fresh was added, TenantConfig feature was added, UUID generator was moved to a different namespace
Bug fixes, config was restructured, tenants:migrate-fresh was added, TenantConfig feature was added, UUID generator was moved to a different namespace.
Changelog will be published when v2.0.0 is released.
Changelog will be published when v2.0.0 is released.
The documentation is updated for v2.0.0-rc1.
Multi-tenant Jobs: Jobs are now automatically multi-tenant. The documentation page covers the small tweaks you will have to make to your config to get
Nothing published for this version
Nothing published for this version
Nothing published for this version
DB storage driver - you don't have to use Redis to store tenants anymore. Relational databases are now supported as well. more info
tenancy:install will do everything except DB/Redis connection creation for you. It will make changes to Http/Kernel.php, create routes/tenant.php, publish config, and (optionally) publish the migration. more infotenants:run more infoNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.