# Embedding an Osmos Uploader

## Overview

Embed the Osmos Uploader within your app or website to offer a self-serve data import experience to your customers, partners, or vendors.  Follow the steps below to embed your first Uploader.

## Prerequisites

1. [Destination Connector](https://docs.osmos.io/destination-connectors)
2. Uploader HTML Snippet (Provided in [Uploader Setup](https://docs.osmos.io/uploader/uploader-setup))
3. Access to your webpage HTML

{% hint style="info" %}
Note:  You can also embed your Osmos Uploader within a React app.  See below for instructions.
{% endhint %}

## Implementing an Osmos Uploader on Your Webpage

**Step 1:** Navigate to your web hosting provider's **page configuration** menu

**Step 2:** Copy the HTML Snippet from the Osmos platform

<figure><img src="https://353417064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYrsDW6vGBTygB1qqSE%2Fuploads%2FOTZZms7rcj7mwehL3YqC%2FCleanShot%202023-07-19%20at%2013.34.54%402x.png?alt=media&#x26;token=d8b7ce2a-8abb-4227-ab87-f2dff3bb76e7" alt=""><figcaption></figcaption></figure>

**Step 3:** Paste the snippet into your web page at the point where you'd like it to display on the page. Include both script tags and the button element together.

**Step 4:** Edit the snippet to set custom **`displayName`** and **`description`** values for schema. These will be shown to the user in place of the actual name. Note that you should not change the ordering of the fields from the order it appears in the snippet example.

<figure><img src="https://353417064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYrsDW6vGBTygB1qqSE%2Fuploads%2F8fsto2c2b6XNFIJioVdu%2FScreenshot%202023-07-11%20at%203.21.53%20PM_11.png?alt=media&#x26;token=93fa157e-be6a-470f-bf21-822bc2617bb1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Many additional configuration options are available. See [Optional Configuration](https://docs.osmos.io/developer-docs/optional-uploader-settings) for more detail.
{% endhint %}

## Embed Osmos Uploader in React App

To Embed Osmos Uploader in a React App, please use the GitHub example below:

{% embed url="<https://github.com/Osmos-io/examples/tree/main/examples/osmos-uploader-with-reactjs-and-typescript>" %}

## Embed Osmos Uploader in NextJS App

To Embed Osmos Uploader in a NextJS App, please use the GitHub example below:

{% embed url="<https://github.com/Osmos-io/examples/tree/main/examples/osmos-uploader-with-nextjs-and-typescript>" %}