NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2261 most downloaded on Packagist
Laravel Livewire modal component
Latest stable
4.0.0
Last release 1 months ago
23 Oct 2026
Release timing varies
gaps range from 8 days to 9 months
Most releases are documented
notes for 25 of 31 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
38 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Removed version from composer install in readme by @johannesMEGABAD in https://github.com/wire-elements/modal/pull/554
component to modalComponent by @nuernbergerA in https://github.com/wire-elements/modal/pull/560Full Changelog: https://github.com/wire-elements/modal/compare/3.0.4...4.0.0
Add #[Locked] attributes to prevent client-side property tampering by @PhiloNL in https://github.com/wire-elements/modal/pull/549
Full Changelog: https://github.com/wire-elements/modal/compare/3.0.3...3.0.4
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add Livewire v4 compatibility by @bee-interactive in https://github.com/wire-elements/modal/pull/544
Full Changelog: https://github.com/wire-elements/modal/compare/3.0.2...3.0.3
Fix modal content visibility by @edwinvdpol in https://github.com/wire-elements/modal/pull/523
Full Changelog: https://github.com/wire-elements/modal/compare/3.0.1...3.0.2
Full Changelog: https://github.com/wire-elements/modal/compare/2.0.13...3.0.1
Full Changelog: https://github.com/wire-elements/modal/compare/2.0.13...3.0.1
- Tailwind v4 support Full Changelog: https://github.com/wire-elements/modal/compare/2.0.13...3.0.0-beta
Full Changelog: https://github.com/wire-elements/modal/compare/2.0.13...3.0.0-beta
Add #[Locked] attributes to prevent client-side property tampering
Fixes focusables selector in modal.js by @wlhrtr in https://github.com/wire-elements/modal/pull/500
min-h-screen with min-h-dvh by @iRaziul in https://github.com/wire-elements/modal/pull/453Full Changelog: https://github.com/wire-elements/modal/compare/2.0.12...2.0.13
Fix #474 error when escape key is pressed when modal not opened
Fix #474 error when escape key is pressed when modal not opened
Dispatch an event to a modal being closed before closing it, so that the modal can prevent it based on its state by @osmianski in https://github.com/w
Full Changelog: https://github.com/wire-elements/modal/compare/2.0.10...2.0.11
Remove always false PHP version comparison if statements by @nimah79 in https://github.com/wire-elements/modal/pull/401
Full Changelog: https://github.com/wire-elements/modal/compare/2.0.9...2.0.10
Fix event duplication when using wire:navigate
Update modal.js by @vladrusu in https://github.com/wire-elements/modal/pull/371
Full Changelog: https://github.com/wire-elements/modal/compare/2.0.7...2.0.8
Update README.md by @kirgus in https://github.com/wire-elements/modal/pull/353
Full Changelog: https://github.com/wire-elements/modal/compare/2.0.6...2.0.7
Nothing published for this version
[V2] Upgrade pattern improvements by @thermiteplasma in https://github.com/wire-elements/modal/pull/344
Full Changelog: https://github.com/wire-elements/modal/compare/2.0.4-beta...2.0.5-beta
Nothing published for this version
Rename the config file, make sure to republish and update your config:
php artisan vendor:publish --tag=wire-elements-modal-config
You can automate the required changes using the following command:
You can automate the required changes using the following command:
php artisan livewire:upgrade --run-only wire-elements-modal-upgrade
The old component name is being deprecated. Replace @livewire('livewire-ui-modal') with @livewire('wire-elements-modal')
@livewire('livewire-ui-modal') with @livewire('wire-elements-modal')arguments is the named property to pass arguments to your modal, for example:$dispatch('openModal', {component: 'edit-user', arguments: {user: 5}})
Livewire v3 now expects named arguments; this means you will have to adjust your events.
Livewire v3 now expects named arguments; this means you will have to adjust your events.
<-- Before -->
<button wire:click="$emit('openModal', 'users')">Show Users</button>
<!-- After -->
<button wire:click="$dispatch('openModal', {component: 'users'})">Show Users</button>
<-- Before -->
<button wire:click="$emit('openModal', 'edit-user', {user: 5})">Edit User</button>
<!-- After -->
<button wire:click="$dispatch('openModal', {component: 'edit-user', arguments: {user: 5}})">Edit User</button>
You can use regular expression to automate this change:
// Regular Expression
emit\('openModal', '([^']+)'(?:, (\{[^}]+\}|@js\(\[[^\]]+\]\)))?\)
// Example 1
$emit('openModal', 'edit-user', {user: 5})
// Matches
$0 = emit('openModal', 'edit-user', {user: 5})
$1 = edit-user
$2 = {user: 5}
// Example 2
$emit('openModal', 'edit-user', @js(['foo' => 'bar']))
// Matches
$0 = emit('openModal', 'edit-user', @js(['foo' => 'bar']))
$1 = edit-user
$2 = @js(['foo' => 'bar'])
// Update all occurrences
dispatch('openModal', {component: '$1', arguments: $2});
In PHPStorm: <img width="410" alt="image" src="https://github.com/wire-elements/modal/assets/1133950/c351aa1f-4637-4a9f-bd41-ba4aad8810fc">
feature: add x-trap by @Silver343 in https://github.com/wire-elements/modal/pull/225
Full Changelog: https://github.com/wire-elements/modal/compare/1.0.7...1.0.8
fixes loading speed issue by moving config reads away from View composer ... by @arukompas in https://github.com/wire-elements/modal/pull/239
Full Changelog: https://github.com/wire-elements/modal/compare/1.0.6...1.0.7
Add id to modal container by @ryangjchandler in https://github.com/wire-elements/modal/pull/198
Full Changelog: https://github.com/wire-elements/modal/compare/1.0.5...1.0.6
Gate instead of Guard facade to authorize actions by @olivsinz in https://github.com/wire-elements/modal/pull/149
If you published modal.blade.php you will need to replace x-on:close.stop="show = false" with x-on:close.stop="setShowPropertyTo(false)" (see diff)
Full Changelog: https://github.com/wire-elements/modal/compare/1.0.4...1.0.5
Updates to remove flashing/disappearing modal fixes issues 26 by @roni-estein in https://github.com/wire-elements/modal/pull/111
Full Changelog: https://github.com/wire-elements/modal/compare/1.0.3...1.0.4
Update path to vendor resources by @Wit3 in https://github.com/wire-elements/modal/pull/101
Full Changelog: https://github.com/wire-elements/modal/compare/1.0.2...1.0.3
Nothing published for this version
Add modal defaults https://github.com/livewire-ui/modal/commit/930791c870b72fa66b62b2f69bfaf169dd736502
Breaking changes to take into account:
Breaking changes to take into account:
@livewireUIScripts has been removed.Any required Javascript will be loaded inline. If you want to include the Javascript in your bundler like Webpack you can use the config to disable Javascript and require the necessary Javascript require('vendor/livewire-ui/modal/resources/js/modal');
livewire-ui-modalIf you published the modal view make sure to make the required changes.
The setActiveModalComponent is sometimes called multiple times resulting in issues with the component history log and could result in errors. This rel
The setActiveModalComponent is sometimes called multiple times resulting in issues with the component history log and could result in errors. This release prevents an already active modal component to be set active (while it is already active).
Add option to change escape behaviour
By default, closing a modal by pressing the escape key will force close all modals. If you want to disable this behavior to, for example, allow pressing escape to show a previous modal, you can overwrite the static closeModalOnEscapeIsForceful method and have it return false.
public static function closeModalOnEscapeIsForceful(): bool
{
return false;
}
When a modal is closed, you can optionally enable a modalClosed event to be fired. This event will be fired on a call to closeModal, when the escape button is pressed, or when you click outside the modal. The name of the closed component will be provided as a parameter;
public static function dispatchCloseEvent(): bool
{
return true;
}
Add option to disable closing modal on click a away:
Add option to disable closing modal on click a away:
public static function closeModalOnClickAway(): bool
{
return false;
}
Change Alpine binding to prevent VueJS conflict https://github.com/livewire-ui/modal/commit/85acc51047ca34a7b269939aff96e7abe665fcf1
Nothing published for this version
Nothing published for this version
Allow emission of events with parameters and no target
Allow emission of events with parameters and no target (https://github.com/livewire-ui/modal/commit/22e8e947a941ffe3e3cc23cdff460399d8673a7d)
Nothing published for this version
Nothing published for this version
One column per quarter.