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

# General File Uploads

> Upload files directly into your My Extole account using our Batch Jobs page.

## Overview

[//]: # "How do I upload files to Extole?"

Our Batch Jobs page, located in the My Extole Tech Center, offers a powerful self-service experience for your file upload needs. This page allows you to quickly and reliably upload file-based events and automate jobs of large files without needing to coordinate with our Support team.

For a recurring inbound file pipeline that should detect, validate, and process files as they arrive, install [File Integration](/technical/platform-integrations/extensions/file-integration) instead.

[//]: ___

<img src="https://mintcdn.com/extole/Y4HlHrsrrzEKq8EE/images/extole/3578174298ce5d9ed3062d0deffa5d7d588adf7db738f13f81e3a0120cae4cd1.png?fit=max&auto=format&n=Y4HlHrsrrzEKq8EE&q=85&s=0716f0f5e7229fa3ea78bceccf827c85" alt="Screenshot showing Our Batch Jobs page, located in the My Extole Tech Center, offers a powerful self-service experience for your file upload needs. This page allows you to..." width="2836" height="790" data-path="images/extole/3578174298ce5d9ed3062d0deffa5d7d588adf7db738f13f81e3a0120cae4cd1.png" />

## Creating a New Job

[//]: # "How do I create a batch job to upload files to Extole?"

Click on the + New Batch Job button to start the job creation process. A drawer-style window will slide out from the right-hand side of your screen with all of the necessary fields to fill in for your job.

<img src="https://mintcdn.com/extole/jL8qwWMZhH32a7N8/images/extole/5b933b8ab3c3a8cfe332bda0bfeabc66c474cbd7d42c6404da15c0b280510cc3.png?fit=max&auto=format&n=jL8qwWMZhH32a7N8&q=85&s=78d3576fc4f17fa437a11e3cff848106" alt="Screenshot showing Click on the + New Batch Job button to start the job creation process. A drawer-style window will slide out from the right-hand side of your screen with all..." width="2574" height="1216" data-path="images/extole/5b933b8ab3c3a8cfe332bda0bfeabc66c474cbd7d42c6404da15c0b280510cc3.png" />

### Required Fields

The required fields include the name of your job, the source type, and the file itself.

<table>
  <thead>
    <tr>
      <th>
        Field
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Name
      </td>

      <td>
        A unique name that describes the content of your file (e.g., Evergreen Refer A Friend Conversions 01072022-01082022).
      </td>
    </tr>

    <tr>
      <td>
        File
      </td>

      <td>
        You can either drag and drop or browse for the file you want to upload. Your file must have an extension of CSV, PSV, or JSON.
      </td>
    </tr>

    <tr>
      <td>
        Source Type
      </td>

      <td>
        The type of file you are uploading. The dropdown includes the following options:\
        Audience\
        Existing File\
        Report\
        New File (default)
      </td>
    </tr>

    <tr>
      <td>
        Batch Jobs Type
      </td>

      <td>
        The type of data included in the file you are uploading. The dropdown includes the following options:\
        Event (default)\
        Optout\
        Approve
      </td>
    </tr>
  </tbody>
</table>

[//]: ___

## Searching for a Job

[//]: # "How do I search for an uploaded file in Extole?"

You can now search for your jobs by typing keywords into the search bar and applying search filters.

<img src="https://mintcdn.com/extole/qcEY2oecClXIoahB/images/extole/74ac54819ce731e0fc240cf93bdfa3cc8d2b4142576158a0b291d7cdbce9245f.png?fit=max&auto=format&n=qcEY2oecClXIoahB&q=85&s=7ff31064df33954e4f076ad2c3435684" alt="Screenshot showing You can now search for your jobs by typing keywords into the search bar and applying search filters." width="2574" height="518" data-path="images/extole/74ac54819ce731e0fc240cf93bdfa3cc8d2b4142576158a0b291d7cdbce9245f.png" />

Apply filters to your search by changing the “Search by:” dropdown criteria. For example, if you select Search by: User and click on the bar, it will generate a list of users for you to browse. Selecting a user will show you all of the jobs that user has created.

[//]: ___

## Sorting Jobs by Status

[//]: # "How do I search for a file based on its upload status?"

In the jobs table, you have the option to sort your jobs based on status. You can select any number of statuses.

<img src="https://mintcdn.com/extole/qYz_vh_4-zD_8v2G/images/extole/1b8cc0b060f965d39f2b61521440c9ad944c403132c26ad0b6c34994cc3d3de3.png?fit=max&auto=format&n=qYz_vh_4-zD_8v2G&q=85&s=c98e79b7b5420d599fbbf4ff11a3d336" alt="Screenshot showing In the jobs table, you have the option to sort your jobs based on status. You can select any number of statuses." width="2574" height="318" data-path="images/extole/1b8cc0b060f965d39f2b61521440c9ad944c403132c26ad0b6c34994cc3d3de3.png" />

### Job Statuses

The job statuses include pending, in progress, done, failed, canceled, and expired.

| Status | Description |
| :- | :- |
| Pending | The job is in our system and getting ready to process. This preparation phase can take up to a couple of minutes. |
| In Progress | The job is actively being processed by our system. The duration of the processing period is dependent on the size of the file. |
| Done | The job has been successfully completed. |
| Failed | The job was unable to be processed. This is most likely due to issues with your file format or duplicated files. |

A file is rejected as a duplicate when its name matches a file already uploaded to your account, including a file that has since expired. A naming scheme that repeats, such as a month and day with no year, therefore fails on the anniversary of an earlier upload, and the feed for that day is lost. Include the year, or another value that never repeats, in every file name.
\| Canceled    | The job was canceled by you before it was completed.                                                                            |
\| Expired     | The job was uploaded more than 90 days ago. These files are removed from our system, but we do retain history that the job ran. |

[//]: ___

## Viewing Job Details

[//]: # "How do I details about an uploaded file in Extole?"

Each job in the table has a detailed view. Clicking on a job will open a drawer-type window from the right-hand side of your screen that lists more in-depth information about the job.

<img src="https://mintcdn.com/extole/qYz_vh_4-zD_8v2G/images/extole/18423ed8dd3813f69354173053958b4765cfdca407aa78519d2d8189898543ce.png?fit=max&auto=format&n=qYz_vh_4-zD_8v2G&q=85&s=6c1e9f186bd903f854403a53eefc5032" alt="Screenshot showing Each job in the table has a detailed view. Clicking on a job will open a drawer-type window from the right-hand side of your screen that lists more in-depth..." width="2576" height="828" data-path="images/extole/18423ed8dd3813f69354173053958b4765cfdca407aa78519d2d8189898543ce.png" />

### Detailed View

Information displayed the detailed view of a job includes the following:

* Name
* Source (clicking this link will download the file)
* Type
* Status
* Valid/Invalid Rows
* Start/Completed Time
* Tags
* Event Names (if all events in your file are the same type)

[//]: ___


## Related topics

- [Files](/technical/platform-integrations/files/index.md)
- [File Integration — Beta](/technical/platform-integrations/extensions/file-integration.md)
- [File-based Events](/technical/platform-integrations/files/file-based-events.md)
- [Upload a file asset](/api-reference/files/upload-a-file-asset.md)
- [Upload manual coupons file](/api-reference/reward-suppliers/upload-manual-coupons-file.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.