Weave Code
Filament Import Laravel Package
konnco/filament-import
Konnco Filament Import adds CSV and Excel import actions to Filament resources. Define fields with validation and uniqueness rules, map spreadsheet columns to model attributes, and import rows into Eloquent records from a simple, configurable action.
konnco/filament-import adds a complete CSV/Excel import flow to any Filament resource. Attach the ImportAction to your table header and users get a guided wizard for uploading files, mapping columns, and validating rows before anything is saved.
The package streams large files in chunks, previews mapped data, and reports per-row errors, so imports stay fast and safe on production data.
- Drag-and-drop CSV/XLSX uploads
- Interactive column-to-field mapping
- Row-level validation with error preview
- Chunked, memory-safe processing
- Customizable actions, templates, and notifications
Frequently asked questions about Filament Import
- What can I use konnco/filament-import for in a Laravel app?
- It adds a Filament import action to a resource so admins can upload CSV or Excel files, map columns to model fields, validate rows, and persist data in chunks from the panel. It is a UI convenience for standard Eloquent resources with flat scalar columns, not a replacement for complex ingestion pipelines. It is only relevant if your admin is already built with Filament.
- How do I install and register konnco/filament-import in Filament?
- Install it with Composer, register the plugin in your PanelProvider, then attach the import action to a resource table and declare the target model and column mapping. A straightforward resource is often a 0.5 to 2 engineer-day integration including validation rules and a smoke test. Confirm the Composer constraints against your Filament version first.
- Which Laravel and Filament versions are supported by konnco/filament-import?
- You need to check the package composer.json for the declared Laravel, PHP, and Filament constraints rather than assuming compatibility. The last release was 2025-04-25, close to the Filament v4 transition, so verify there is no open issue or PR needed for your Filament major. Treat version alignment as the main feasibility gate before committing.
- Does konnco/filament-import support both CSV and Excel uploads?
- Yes, the package is described as accepting CSV or Excel files through the Filament import action. The underlying spreadsheet parser and enforced file-size or row-count limits are not stated in the overview, so review them for your use case. For xlsx files, pay attention to zip/XML expansion and memory use on large uploads.
- How does column mapping work with konnco/filament-import?
- The import flow gives users a mapping step where uploaded columns are matched to the target model fields before rows are persisted. You declare the target model and mapping when attaching the action to a Filament resource table. This keeps the import user-facing and avoids custom parsing code for simple resources.
- How are row validation errors reported by konnco/filament-import?
- The package validates rows before import, but the exact way per-row failures are surfaced must be verified in a spike. It may provide row-level error reporting or fail the batch, and that matters for usability. Test a file with deliberately invalid rows and confirm whether users get a downloadable error report.
- Does konnco/filament-import import large files in chunks or use a queue?
- The package description says data is imported in chunks, but it does not state that the work is queued. The assessment expects the import likely runs synchronously inside the request, so large files can hit PHP memory and time limits. Confirm chunk size, parser limits, and whether any queue support exists before using it for high-volume imports.
- Will a failed row roll back the entire konnco/filament-import batch?
- Do not assume transactional behavior; verify whether the write path is wrapped in a transaction and how partial success is handled. The dangerous failure mode is a run that writes thousands of rows, fails later, and still reports success. Test failure at a late row and check whether model events, observers, and audit logs fire as expected.
- Does konnco/filament-import respect Filament multi-tenancy and unique constraints?
- The import runs inside the existing authenticated Filament panel and inherits its policies and middleware, but per-tenant scoping on the target model must be checked explicitly. Upsert semantics are also not established, so confirm whether the package is create-only or can update existing records. Handle unique-constraint conflicts and update-existing behavior downstream if the package does not.
- Is konnco/filament-import actively maintained and production-ready?
- It has roughly 240 stars and zero recorded dependents, so it is findable but has little public production validation. The MIT license makes it forkable and patchable, but a small maintainer base means upgrade lag is a realistic risk. Treat it as unproven, review open issues, and confirm Filament v4 compatibility before relying on it.
Weaver
How can I help you explore Laravel packages today?