> ## 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.

[//]: ___

<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.                |
| 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)

[//]: ___