Start here

Download a sample file, open a list and press its Import button. Every import button here is WarpImportAction with an ordinary Filament importer — "View code" on each list shows it. Nothing is written until you press Import, and every import can be undone.

Try a file

Products with mistakes

Prices like "$1,200", dates like "Jan 5, 2026", Yes / Y / No, a price "abc", an unknown category, a duplicate SKU and a row without a name. Tick "Keep the saved value when a cell in the imported data is empty" and that row only updates its price. Fix the rest in the review, import, then undo.

Download products.csv

Products with photos

Download both files and import products-with-photos.csv. On the Columns step the wizard sees the photo file names and asks for them: add product-photos.zip there, and the photos are taken from the ZIP by file name. One row names a photo that is not in the ZIP.

Download products-with-photos.csv Download product-photos.zip

5,000 products

1,500 changes and 3,500 new products. Skip the rows with errors and import, then fix them from the result — map "Kitchenware" and "Gadgets" to categories — and import them into the same import.

Download products-5000.csv

Customers

Countries written as "UK", "USA" and "Deutschland" and a tier "VIP" the app does not have. Press Choose… next to an error to map the values, save a template and open the file again.

Download customers.csv

Headers from another system

A CRM export with headers like "Client ID", "Mail" and "Membership level". Press "Suggest with AI" on the columns, then open the errors of Nation and Membership and press it again: "England" becomes United Kingdom and "VIP" Gold. In this demo the answers come from a short built-in list; in your app, from Claude.

Download customers-crm.csv

Orders and items

An Excel workbook with orders in one sheet and their items in another, linked by the order number.

Download orders.xlsx

Approval

Import with approval

On Customers, press "Import with approval", import customers.csv and request approval. Then choose "Act as the manager" in the user menu (top right): the manager gets a notification, reviews the same changes and approves or sends the import back.

Download customers.csv

After importing

Imports

Every import with what it created, changed and could not import. Open one to see its rows, resume it or undo it. Download gives back what was imported, as a CSV.

Sync with a full list

Tick "For existing products that are not in the imported data: mark them as not for sale" and import products-5000.csv. The 500 products that are not in products-5000.csv are listed in the review under "Not in imported data". When you import, those 500 are marked as not for sale (the Active column in the product list shows ×), and "Undo this import" brings them back.

Download products-5000.csv

Scheduled import

Import products.csv, then press "Run on a schedule…" on the result. Pick supplier-prices.csv — the supplier drops it in storage — and save. On Scheduled imports, press "Run now": the new prices are checked with the same columns and imported, and the list shows what happened.

Download products.csv

Modal or full screen

The import opens as a large modal over the list. On Products, press "Full-screen import" to compare: the same wizard fills the whole window (-⁠>modalWidth(Width::Screen)). On a phone both are full screen.

Paste from a spreadsheet

Copy cells from Excel or Google Sheets — with a header row — and paste them into the import window instead of choosing a file.

Files from different countries

German products

Semicolons and decimal commas, as German Excel saves them: 1.250 € and 2.480,00 €, 31.12.2026 and 15. Januar 2026, ja / nein. Open the clean-up of Price: Warp ticked "Decimal comma" from the file, so 1.250 is one thousand two hundred fifty.

Download products-de.csv

French products

Spaces in numbers (1 890,00 €), 13/02/2026 and 05/06/2026, 1er février 2026, oui / non. The 13 tells Warp the day comes first, so 05/06/2026 is 5 June.

Download products-fr.csv

Japanese products

Shift_JIS, as Japanese Excel saves it: １，２００円, △300, 令和8年1月5日, はい / いいえ and ○ / ×.

Download products-ja.csv

Japanese customers

Japanese headers, full-width e-mail addresses and phone numbers, prefectures by name and ranks written as ゴールド and 一般.

Download customers-ja.csv

Japanese orders

The orders workbook with Japanese headers (受注番号, 数量) and an era date.

Download orders-ja.xlsx

1. Turn it on

Add -⁠>schedules() to the import action. After an import, the result offers "Run on a schedule…", where users name the schedule, say where the file is and how often to run it.

use App\Import\Filament\Imports\ProductImporter;
use Qalainau\FilamentWarpImport\Actions\WarpImportAction;

protected function getHeaderActions(): array
{
    return [
        WarpImportAction::make()
            ->importer(ProductImporter::class)
            ->schedules(
                // Who may create schedules (default: true)
                condition: fn (): bool => auth()->user()->isAdmin(),
                // Laravel disks users may pick files from ([] = links only)
                disks: ['supplier'],
                // Allow links: http, https and Google Sheets share links
                urls: true,
                // Allow links to 127.0.0.1, 10.x, 192.168.x and other internal addresses
                privateNetwork: false,
            ),
    ];
}

2. From a link

Choose "At a link" and paste the address of a CSV or Excel file. A Google Sheets share link is fetched as its CSV export; share the spreadsheet with anyone who has the link. Only http and https are allowed, and links to internal network addresses are refused, also where a redirect leads.

# A CSV or Excel file on the web
https://supplier.example.com/feeds/prices.csv
https://supplier.example.com/feeds/stock.xlsx

# A Google Sheets share link (the tab in #gid) …
https://docs.google.com/spreadsheets/d/1AbCdEfGhIjKlMnOpQrStUv/edit#gid=0
# … is fetched as its CSV export
https://docs.google.com/spreadsheets/d/1AbCdEfGhIjKlMnOpQrStUv/export?format=csv&gid=0

# Refused: internal network addresses
http://192.168.1.20/prices.csv

3. From storage

Choose "In storage": the .csv, .tsv, .txt and .xlsx files on the disks you listed are offered. A disk is any Laravel filesystem disk, so your supplier can upload to an SFTP server or an S3 bucket. List a disk that holds import files only: everyone who may create schedules sees its file names.

// config/filesystems.php
'disks' => [
    // An SFTP server your supplier uploads to
    // composer require league/flysystem-sftp-v3 "^3.0"
    'supplier' => [
        'driver' => 'sftp',
        'host' => env('SUPPLIER_SFTP_HOST'),
        'username' => env('SUPPLIER_SFTP_USERNAME'),
        'password' => env('SUPPLIER_SFTP_PASSWORD'),
        'root' => '/outgoing',
    ],

    // Or an S3 bucket
    // composer require league/flysystem-aws-s3-v3 "^3.0"
    'supplier-s3' => [
        'driver' => 's3',
        'key' => env('SUPPLIER_AWS_ACCESS_KEY_ID'),
        'secret' => env('SUPPLIER_AWS_SECRET_ACCESS_KEY'),
        'region' => env('SUPPLIER_AWS_DEFAULT_REGION'),
        'bucket' => env('SUPPLIER_AWS_BUCKET'),
    ],
],

// The import action: ->schedules(disks: ['supplier', 'supplier-s3'])

4. In this demo

Storage only. The "supplier" disk is a folder on the demo server, and the demo puts supplier-prices.csv in it. Links are turned off because the demo is public.

// app/Providers/Filament/DemoPanelProvider.php: a folder on the demo server
config(['filesystems.disks.supplier' => [
    'driver' => 'local',
    'root' => storage_path('app/supplier'),
]]);

// app/Filament/Resources/Products/Pages/ListProducts.php
WarpImportAction::make()
    ->importer(ProductImporter::class)
    ->schedules(disks: ['supplier'], urls: false),

5. Each run

CSV, TSV, text or .xlsx (the first sheet), UTF-8, UTF-16 or Shift_JIS, up to 100 MB. Columns are matched by their header names, so another order or extra columns still work. If a mapped header is gone, the run fails and names it. Rows with errors stop the run, or are skipped if you chose so.

# The headers of the first import
SKU,Product name,Category,Price,Stock,Active,Released

# Still imported: another order, an extra column
Price,SKU,Product name,Notes,Category,Stock,Active,Released

# Fails and names "Price": a mapped header is gone
SKU,Product name,Category,Stock,Active,Released

6. On your server

Warp adds warp-import:run-schedules to Laravel's scheduler, every minute. You need the usual cron entry and a queue worker. Nothing runs while a schedule is paused.

# crontab -e: Laravel's scheduler, every minute
* * * * * cd /path-to-your-app && php artisan schedule:run >> /dev/null 2>&1

# A queue worker for the runs (Supervisor, Forge, Ploi …)
php artisan queue:work

# Run the schedules that are due now, by hand
php artisan warp-import:run-schedules

1. Choose who approves

Add -⁠>requireApproval() to the import action. approvers: lists who can approve, and when: says who needs approval. The approvers are set by the developer in code, so the person importing never picks them on screen. The person who asks can never approve their own import, even if they are in the list.

use Qalainau\FilamentWarpImport\Actions\WarpImportAction;

WarpImportAction::make()
    ->importer(CustomerImporter::class)
    ->requireApproval(
        // Who can approve: any users (a query, a collection or an array)
        approvers: fn () => User::query()->where('role', 'manager')->get(),
        // Who needs approval (default: everyone). Here managers import directly
        when: fn (User $user): bool => $user->role !== 'manager',
    ),

2. Ask for approval

The person importing goes through the review as usual. The import button becomes “Request approval for … rows”, with an optional note for the approver. Once asked, nothing is written and the review becomes read only. “Withdraw request” takes it back so the rows can be edited again.

Clerk     Check 42 rows
          → Request approval for 42 rows   (note: "Prices for October")
          → Waiting for approval: nothing is written, the review is read only
          → Withdraw request               (to edit the rows again)

3. Tell the approvers

Approvers get a Filament database notification (the bell at the top right). “Review” in the notification opens the review of that import. It is also listed as “Waiting for approval” in the import history, so a missed notification is not a lost import. The panel needs -⁠>databaseNotifications() and the user model Laravel’s Notifiable. To also send an email or a Slack message, listen to ImportApprovalRequested, ImportApproved and ImportRejected.

// app/Providers/Filament/AdminPanelProvider.php: the bell at the top right
$panel->databaseNotifications();

// app/Models/User.php
class User extends Authenticatable
{
    use Notifiable;
}

// Also by email or Slack: listen to the events (each has the ImportRun as $run)
use Qalainau\FilamentWarpImport\Events\ImportApprovalRequested;
use Qalainau\FilamentWarpImport\Events\ImportApproved;
use Qalainau\FilamentWarpImport\Events\ImportRejected;

Event::listen(ImportApprovalRequested::class, function (ImportApprovalRequested $event) {
    Mail::to('managers@example.com')->send(new ImportWaitingForApproval($event->run));
});

4. Approve or send back

The approver sees the same review as the person who asked: the new rows, the changed rows (before and after) and the saved data that is not in the imported data. “Approve and import … rows” writes them, only then (through the queue for many rows). “Send back…” returns it with a reason. Approvers cannot change rows. Either way the person who asked is notified; a sent-back import shows the reason in the review, so they fix it and ask again. After importing, both can undo it.

Manager   (bell) "Clerk asks you to approve an import" → Review
          → the same review: new rows, changes (before → after), records not in the data
          → Approve and import 42 rows     → written; Clerk is notified
          → Send back… "The mug costs 900" → nothing written; Clerk is notified,
                                             fixes the rows and asks again

5. In this demo

Only the Manager (manager@example.com) can approve “Import with approval” on Customers, and the Manager imports without approval. Switch between the demo user and the Manager in the user menu at the top right.

// app/Filament/Resources/Customers/Pages/ListCustomers.php
WarpImportAction::make('warpImportApproval')
    ->label('Import with approval')
    ->importer(CustomerImporter::class)
    ->requireApproval(
        approvers: fn () => User::query()->where('email', 'manager@example.com')->get(),
        when: fn (User $user): bool => $user->email !== 'manager@example.com',
    ),