Skip to main content
An embedded Dromo importer runs inside your web application and guides users through uploading, matching, cleaning, and reviewing their data. Your application configures the import and receives the cleaned results when the user finishes.

​
Choose an SDK

JavaScript

Use the core SDK in any browser application.

React

Use the Dromo component and React props.

Angular

Use the Angular component, inputs, and outputs.
All three integrations use the same fields, settings, hooks, and result model. The React and Angular packages wrap the JavaScript SDK with framework-native components.

​
How an embedded import works

1

Configure the importer

Provide a frontend license key, fields, settings, and user metadata. You can also use a saved schema from Schema Studio.
2

Open it in your application

The SDK displays Dromo in an iframe within a modal or inline container. Users upload a file and resolve mapping or validation issues without leaving your application.
3

Receive cleaned results

Handle the onResults callback to send the validated data to your application. You can optionally sync imports to Dromo and receive webhooks.

​
Embedded or headless?

Use an embedded importer when users should see and control the import flow. Use the Headless API when imports should begin from your backend or run without an initial user interface.
Embedded imports can run in Private Mode, where end-user file data remains in the browser.