> ## Documentation Index
> Fetch the complete documentation index at: https://atomictoolkit.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload Data

> Upload data to Arweave.

This function allows you to upload data to Arweave.

## Usage

```ts theme={null}
const res = toolkit.utils.uploadData(opts);
```

## Input Parameters

The function takes in a object containing the following parameters:

* **type: `data | File`**: The type of data to upload.
* **data: `string | File`**: The data to upload. Can be a file or path to a file in case of node environments.
* **tags: `Tag[]`**: Tags to be added to the transaction.

## Return Value

The function returns a promise that resolves to `UploadResponse`, `Transaction`, or `TurboUploadDataItemResponse` depending on whether Irys or Turbo are used or not.

* `UploadResponse` - Returned when Irys is used. It contains fields such as:
  * **id: `string`** - The transaction ID of the collection.
  * **signature: `string`** - The signature used while creating the collection.
  * **timestamp: `number`** - The timestamp of the transaction.
* `Transaction` - Returned when Arweave is used. It contains fields such as:
  * **id: `string`** - The transaction ID of the collection.
  * **owner: `string`** - The owner of the collection.
  * **tags: `Tag[]`** - The tags of the collection.
  * **data: `Uint8Array`** - The data of the collection.
  * **signature: `string`** - The signature used while creating the collection.
* `TurboUploadDataItemResponse` - Returned when Turbo is used. It contains fields such as:
  * **id: `string`** - The transaction ID of the collection,
  * **timestamp: `number`** - The timestamp of the transaction,
  * **winc: `string`** - The amount of Turbo Credits, in Winston Credits, spent on the upload,
  * **version: `string`** - The version number of the upload receipt returned,
  * **deadlineHeight: `number`** - The latest block height in which the uploaded data will be settled on Arweave,
  * **dataCaches: `array`** - A list of nodes where the data was cached while upload to Arweave is pending,
  * **fastFinalityIndexes: `array`** - A list of nodes where data is made available while waiting for it to settle on Arweave,
  * **public: `string`** - The public key of the wallet used for upload,
  * **signature: `string`** - The signature used while creating the collection,
  * **owner: `string`** - The owner of the collection.

## Example

```ts theme={null}
const file = new File(['hello world'], 'hello.txt', { type: 'text/plain' });

const res = await toolkit.utils.uploadData({
    type: 'file',
    data: file,
    tags: [
        { name: 'Content-Type', value: 'text/plain' },
        { name: 'Title', value: 'Hello World' },
    ],
});
```