Standard Data
Import Column Mapper
Lets people map columns from an uploaded file onto your destination fields, with a sample value per column and clear wording for anything left unmapped or assigned twice — so an import gets caught before it runs, not after it fails.
$ velocityx add standard-import-column-mapper
Built for react.
Needs react already installed
as a peer dependency.
An Astro-only project needs @astrojs/react wired up first — this won't run on its own in plain Astro.
Full docs for Import Column Mapper →
Needs a licence key —
subscribe here, then
velocityx loginonce.
Map your columns
Choose which field each column from your file should fill. Required fields are marked and must be mapped before import can continue.
| Source column | Sample value | Maps to |
|---|---|---|
| First Name | Priya | |
| Last Name | Nakamura | |
| Email Address | priya.n@example.com | Not mapped — this column is skipped. |
| Company | Meridian Health | |
| Phone | +61 412 555 018 |
Props
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| sourceColumns | array | No | [] | |
| destinationFields | array | No | [] | |
| value | undocumented | Yes | ||
| onChange | undocumented | Yes | ||
| className | string | No | "" |
3 fields in this table have an undocumented type — see source for the exact shape.
File this creates
The CLI writes this path into your project, relative to its root — nothing else moves.
components/velocity/standard-import-column-mapper/ImportColumnMapper.jsxUsing the Import Column Mapper component
Install it with velocityx add standard-import-column-mapper.
The CLI writes the source straight into your project — no runtime dependency, no registry
lock-in, and it themes itself from the same primary-*/accent-* scale as the rest of the library.
Related components
More from Standard Data.
A query-builder for data tables — stack field/operator/value condition rows and combine them with a shared AND/OR joiner, so users compose multi-condition filters without writing a query language.
reactCheckbox row selection for a data table with a correctly indeterminate select-all, a live selected count, and a contextual action bar that appears only once something is selected, so bulk edit, export, or delete never need a separate mode.
reactTurns a truncated table cell into a focus-trapped popover showing the full value with a one-click copy button, so long IDs, JSON blobs or notes never need their own column width.
reactA settings popover for showing or hiding table columns, with the chosen layout remembered between visits so people don't have to rebuild their view every time they come back.
react