Embedded CSV importer — add data import to your SaaS

An embedded CSV importer is a drop-in widget that lets your own users upload, map and validate spreadsheets inside your product — instead of emailing you files or wrestling with a raw file input you built yourself. Mildport is an embeddable importer with one extra property most don’t have: you can self-host it so the data stays in your infrastructure.

If you’re adding “import your data” to a SaaS product, you’re really signing up to handle CSV and Excel, weird encodings, leading-zero ZIP codes, columns in the wrong order, half-empty rows, and a different header layout from every customer. That’s the work an embedded importer absorbs for you.

Build vs buy

	Build it yourself	Embed Mildport
Time to first import	Weeks (and it grows)	A Quickstart
Column mapping	You design and maintain it	Deterministic, explainable matcher built in
Formats	Whatever you implement	CSV, TSV, XLSX, ODS, JSON, XML, PDF tables, OCR
Validation & fix UX	You build the grid	Review-and-fix grid included
Data location	Yours	Yours — self-hosted in your VPC
Maintenance	Forever yours	The engine’s

The classic trap: an in-house importer is a one-week task that becomes a permanent backlog item. Every new customer brings a file shape you didn’t plan for.

What you embed

One framework-agnostic custom element — works in React, Angular, Vue or plain HTML, with a React wrapper if you want it:

npm install @capitality-io/import-suite-ng
# React wrapper, optional:
npm install @capitality-io/import-suite-react

<mildport-import
  api-base-url="https://imports.your-infra.example"
  license-key="SIGNED_TENANT_KEY"
></mildport-import>

You declare your targets (the fields you want), and clean rows arrive via a DOM event:

el.addEventListener('import-applied', e => sync(e.detail));

Attributes in, DOM events out — no iframe, no SDK lock-in. Details in Configure and Events & apply.

Why Mildport specifically

• Self-hostable. The same widget is backed by an engine you can run in your own infrastructure — files never leave your VPC. See self-hosted CSV importer.
• Explainable mapping. Visible match scores and a replayable pipeline, not a black box.
• Real-world inputs. Spreadsheets, PDF tables and OCR’d scans, not only tidy CSV.
• AI when it helps. Optional, evidence-gated AI judge for the uncertain tail — your model, off by default.

FAQ

What is an embedded CSV importer? A drop-in component your users use to upload a spreadsheet, map columns to your fields, fix errors and submit clean records — without you building the upload, parsing, mapping and validation UI.

Should I build or buy a CSV importer? Building looks simple until encoding issues, Excel quirks, header matching, large files and per-customer schemas pile up. Buying gives you a tested mapping-and-validation engine now; Mildport adds the option to self-host it.

Does Mildport have a React component? Yes — a framework-agnostic <mildport-import> element plus a React wrapper, so it embeds in React, Angular, Vue or plain HTML.

---

Add import to your product — start at mildport.com or read the Quickstart.