SIGNALS Documentation
API Reference

Imports

Run the import wizard, review batches, and manage migration plans and profiles.

Overview

Imports is the admin entry point for bringing data into Signals — batch history, the import wizard, migration plans, and reusable profiles.

Where it lives

Route: /admin/settings/imports (admin.settings.imports.index)

Related: create wizard, batch show, plans, and profiles under /admin/settings/imports/*.

Open Admin → Data → Imports. Requires imports.view (ImportBatch policy). Creating batches needs imports.create.

Key workflows

  • Browse past import batches (filename, target model, status, row counts).
  • New import opens the wizard when permitted.
  • Section tabs cover Imports, Migration Plans, and Profiles.

Possible duplicates

On the wizard's preview step, rows that resemble records you already have are listed under Possible duplicates for accounts and catalogue items.

  • An exact match on the batch's duplicate fields is merged as it always has been, silently, under the batch's conflict strategy.
  • A match that differs only in case, punctuation or spacing (Acme Ltd. vs Acme Ltd) is treated the same way.
  • Anything merely similar is only ever offered. Choose Treat as duplicate to merge the row into that record, or Not a duplicate to import it as new. A row you leave alone imports as a new record.

Each candidate carries a badge showing why it was offered. Saying "not a duplicate" is remembered for that batch and row — the same candidate is never offered again.

Addresses use exact matching only.