Getting Started

An overview of how to setup the OneSchema Embeddable Importer

OneSchema is the embeddable CSV importer for developers used by product and engineering teams to save months of development time when compared to building an importer in-house (demo video).

Setting up OneSchema's Embeddable Importer takes less than 20 minutes and has four main steps:

  1. Define the import rules 5 mins
  2. Quickly embed using the provided code snippet 3 mins
  3. Customize the look and feel of the Importer 4 mins
  4. Handle ingesting the clean data

To begin, request a demo if you have not yet done so.

Four steps to get started with OneSchema

Four steps to get started with OneSchema

Example JS embedding code snippet

  <script src=""></script>
  .oneschema-iframe {
    width: 100vw;
    height: 100vh;
    border: none;
    position: absolute;
    right: 0;
    top: 0;
    z-index: 1000;
  <script type="text/javascript">
      if you would like to use this sample in a JavaScript file as part of your
      build you can install the npm package '@oneschema/importer', copy this
      sample into a new file, and add this import statement:
      import oneschemaImporter from '@oneschema/importer'
    const importer = oneschemaImporter({
      clientId: "<YOUR_CLIENT_ID_HERE>",
      templateKey: "<YOUR_TEMPLATE_KEY_HERE>",
      importConfig: { type: "local" },
      userJwt: "<YOUR_JWT_HERE>",
      devMode: false,

    function launchOneSchema() {

      importer.on("launch", (data) => {
        // TODO: handle launch

      importer.on("success", (data) => {
        // TODO: handle success

      importer.on("cancel", () => {
        // TODO: handle cancel

      importer.on("error", (message) => {
        // TODO: handle errors

  <button onclick="launchOneSchema()">Launch embed</button>

The snippet shown is JavaScript however OneSchema also has SDKs for React, Angular, and Vue.

What’s Next

Create a template - the rules around your import