# Export raw reporting data

> Exporting your reporting data to CSV will give you quick access to customer and conversation details for one-off analysis.

Source: https://help.kustomer.com/en_us/exporting-raw-reporting-data-r13iv58rf

Last updated: 2026-05-26T18:02:55.747Z

Exporting your reporting data to CSV will give you quick access to customer and conversation details for one-off analysis. You can export this data one time or schedule the export to be sent out via email at scheduled times. With the CSV Export you can:

*   Export up to 30 days of data to multiple users.
*   Choose the object you want to export. 
*   Define the object attributes you want to export as columns in the CSV.
*   Arrange your attributes in the order you'd like them to appear in your CSV.

**Note:** This feature is designed for one-off or recurring data exports up to a daily frequency. We recommend using our real-time events stream if you’d like to continually export your Kustomer data to an external system, such as Redshift. Please [contact us](mailto:support@kustomer.com) if you’re interested in this feature.

**Who can access this feature?**

**User types**

Managers can export a CSV.

  

### In this article

*   [Add a new export](#Adding)
*   [Choose how often your export runs](#RunExport)
*   [Select your data attributes](#DataAttributes)
*   [Order your data and execute your export](#OrderData)
*   [Manage your exports](#ManageExport)

### Add a new export

You can create data exports to help you perform an analysis on your customer data outside of the Kustomer platform.

1.  Go to **Reporting![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/fa66ab719673b6f337dc4abd1ccbda7f.png)**and then select **Data Exports**.  
    ![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/09a81b870795fe9cba67d1d52639599c.png)
2.  Select **Add Export**.
3.  Add a name and enter the email addresses of everyone receiving the email containing the link to download the export. You can add up to 50 recipients.
4.  Optionally, enter a message.
5.  Select whether to export the data once or schedule a recurring export.
6.  Choose the data you want to export.
7.  Select **Save**.

The recipients will receive an email from Kustomer with your message and a direct link to download the CSV.

### Choose how often your export runs

You can choose to run your **Export Now** or **Schedule Recurring Export**. If you choose to schedule a recurring export, you also have to set how often the export will be sent to your recipients, along with the date of when the export will stop being shared. You can schedule an export to send **Daily**, **Weekly**, or **Monthly**.

![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/855e024cdb34a4272c62749161a29b10.png)

**Note:** You can schedule up to 50 exports.

The Data Date Range section is where you can specify the date range of the data included in any export. The default value is the current day, and you can export up to the last 30 days worth of data. The default value is EST. These values differ based on the type of export you are running:

**Export frequency**

**Data date range** 

  

Current Day

Past 30 Minutes

Past 60 Minutes

Past 24 Hours

Past 7 Days

Past 30 days

Export Now

X

X

X

X

X

X

Schedule Recurring Export

  

  

  

X

X

X

  

You can also specify the time zone for the date range. The dates and timezone you select here are applied to when the object was created. For example, if you select June 1, 2020 - June 10, 2020 EST, the Conversation object type exports will reference and export conversations that were created (createdAt) between 12:00:00AM EST June 1, 2019 and 11:59:59PM EST June 10, 2019.

### Select your data attributes

You can export data from one of the following objects:

*   [Conversation standard attributes](https://help.kustomer.com/en_us/data-export-conversation-standard-attributes-Sk_4kKhzi)
*   [Conversation Views (Handle Time) standard attributes](https://help.kustomer.com/en_us/data-export-conversation-views-handle-time-standard-attributes-S156RZQms)
*   [Customer standard attributes](https://help.kustomer.com/en_us/data-export-customer-standard-attributes-Sy14oImQs)
*   [Message standard attributes](https://help.kustomer.com/en_us/data-export-of-message-standard-attributes-HJSBh2UVj)
*   [Note standard attributes](https://help.kustomer.com/en_us/data-export-of-note-standard-attributes-rJ4fiiFVi)

After choosing the object type, select **Add Attributes** to see a list of properties you can choose to export related to that specific item. In the example below, selecting **Conversation** from the Object Type drop-down menu lists all of the available conversation attributes. You can export up to 25 attributes. 

![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/c06362804eca968f03ba30ccda4a3b3b.png)

The names in the list are the API names given to the conversation attributes. Where possible, we've also included the Display Name (the label of this field in the UI) as well as Sample Data (an example of how exported data for this attribute should appear) to make it easier for you to pick the correct attribute. For more information about the different attributes available for each item, see our [API documentation](https://developer.kustomer.com/kustomer-api-docs/reference/introduction).

Once you select the attributes you want to export, select **Save**.

### Order your data and execute your export

After selecting the attributes you want to export, you'll see them listed on the Create Data Export page. These values will be your column headers; you can re-order them by dragging and dropping them to your desired location.

![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/1dbc507c634d38e3740ab60c22e3ded0.gif)

Now that your export is fully configured, you can either **Save & Export** (run now) or **Save as Draft** (store all of your attributes to run at a later date). 

Once you choose to Save & Export you’ll have to briefly wait for the data to be compiled and emailed to you. This time will depend on how much data you have, so if you have a large support organization, try exporting a single day of data to understand processing times better. 

### Manage your exports

The Manage Data Exports section of the page allows you to manage both your scheduled and one-time exports.

![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/d294122061812a02627c6d91437d3571.png)

Here, you can view exports that are actively running, in a draft state, paused, or completed. The Drafts tab lists any exports you previously configured yet never run and is where you can execute them. You can also select the menu icon![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/f7bdc49afa5402d23cbf57df7477239b.png) for each export to view additional actions you can take. These actions will differ based on the export's current status. The available actions are:

**Current status**

**Available action**

  

**Scheduled Exports**

**One-time Exports**

Active/Running

Edit, Duplicate, Pause, Delete

n/a

Drafts

Edit, Duplicate, Reactivate, Delete

Edit, Duplicate, Run Now, Delete

Paused/Complete

Duplicate, Delete

Duplicate

###   

### **Why CSV export numbers may differ from dashboard metrics**

CSV exports and dashboard reports may show different totals for the same time period. This is expected behavior caused by different attribution models.

****Dashboard metrics**** count conversations based on specific attribution logic — for example, the Personal Performance Dashboard counts conversations marked done by a specific agent during the selected time period.

****CSV search exports**** pull conversations based on search filter criteria. The export may include:

*   Conversations that were reopened and re-closed during the period, counted differently than on the dashboard.
*   Conversations matching the filter criteria through a different attribution path.

If you observe a significant discrepancy and need clarification on which numbers are correct for your use case, contact Kustomer Technical Support with the specific report, export, time period, and agent or team in question.

### **Troubleshoot data export failures**

If a data export fails with "Export failed to be created":

*   Verify the date range does not extend into the future.
*   Start with a narrow date range (for example, one day) and expand gradually.
*   For large exports, use the Kustomer API instead of the UI export tool.

****Note:**** Failed exports require full reconfiguration. There is no option to retry a failed export with the same settings.