pharaonic / livewire-select2

4.0.0 2026-10-24 07:00 UTC

Requires

• php: >=8.1 <8.6
• illuminate/http: ^10.16 || ^11.0 || ^12.0 || ^13.0
• illuminate/routing: ^10.16 || ^11.0 || ^12.0 || ^13.0
• illuminate/support: ^10.16 || ^11.0 || ^12.0 || ^13.0
• illuminate/view: ^10.16 || ^11.0 || ^12.0 || ^13.0
• livewire/livewire: ^4.3.4
• pharaonic/livewire-assistant: ^4.0

Requires (Dev)

• laravel/pint: ^1.20
• orchestra/testbench: ^8.0 || ^9.0 || ^10.0 || ^11.0
• pestphp/pest: ^1.23 || ^3.8 || ^4.0
• phpstan/phpstan: ^2.1.33
• phpunit/phpunit: ^9.6.33 || ^11.5.50 || ^12.5.8

MIT

• Moamen Eltouny (Raggi)

• jquery
• laravel
• select
• select2
• livewire
• livewire-select2

Published on Packagist.org on 2026-10-24 07:00 UTC

README

Select2 for Livewire components.

Two-way wire:model binding, dynamic and dependent selects, and templates, built on Livewire Assistant.

Installation

composer require pharaonic/livewire-select2

Load jQuery and Select2 as usual, then add the scripts once in your layout, before or after @livewireScripts:

@livewireScripts
@livewireSelect2Scripts

No Node build is needed. The 4.x line supports Livewire 4.3.4+ on Laravel 10.16+, 11, 12, and 13 with PHP 8.1 to 8.5.

Coming from 1.2? Run composer require pharaonic/livewire-select2:^4.0. Your markup keeps working; the documentation lists what changed.

Usage

<div wire:ignore>
    <select data-pharaonic="select2" wire:model.live="country" data-placeholder="Choose a country" data-clear>
        <option value=""></option>
        <option value="1">Egypt</option>
        <option value="2">Jordan</option>
    </select>
</div>

The select follows country both ways: picking an option updates the component, and setting the property on the server updates the widget. Shorthands such as data-tags, data-clear, data-search-off, and data-parent cover common options; data-options takes any other Select2 option as JSON.

Documentation

Read the full Livewire Select2 documentation for options, dependent selects, templates, bundlers such as Vite, and upgrading from 1.2.

Support & Security

See SUPPORT.md and SECURITY.md.

License

MIT. See LICENSE.