> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/~/changes/J8IbZkP6ASUZu2oBhGi2/process-flows/error-reporting-and-exception-handling/run-logs-and-queue/working-with-run-logs/downloading-run-logs.md).

# Downloading run logs

## Introduction

If required, you can download run logs for a completed process flow run in CSV format, for use outside of Patchworks. 

## Need to know

Run log exports are completed in CSV format. The exported file includes two columns with `level` and `message`  headers. For example:

{% code lineNumbers="true" %}

```
level,message
info,"Flow initialised by Manual trigger."
info,"Flow step connector started"
info,"Connecting to Shopify"
error,"Connection to Shopify failed"
warning,"Errno: 60"
error,"Flow step connector failed: attempt (1/2)"
warning,"Error: 'SSL: no alternative certificate subject name matches target host name 'patchworks-docs-demo.myshopify.com.myshopify.com''"
info,"Flow step connector started"
info,"Connecting to Shopify"
error,"Connection to Shopify failed"
warning,"Errno: 60"
warning,"Error: 'SSL: no alternative certificate subject name matches target host name 'patchworks-docs-demo.myshopify.com.myshopify.com''"
error,"Flow step connector failed: attempt (2/2)"
error,"Flow run #01hsdkz31xzfe6jpvcpz7fgtf5 failed."
error,"Error: Internal error, please contact support if this issue persists."
```

{% endcode %}

## The steps

To download run logs for a specific process flow run, follow the steps below. 

**Step 1**\
Log into the Patchworks dashboard and [access your run logs & queue](/product-documentation/~/changes/J8IbZkP6ASUZu2oBhGi2/process-flows/error-reporting-and-exception-handling/run-logs-and-queue.md#accessing-your-run-logs-and-queue-page).

**Step 2**\
Click the ellipses icon to access additional options for the log entry, then select the **download logs** option - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FtwPF61zi0vvex9bWysXX%2Fdownloading%20logs%201.png?alt=media&amp;token=c5801554-dfda-41ba-b1c4-9c2d80db6f62" alt=""><figcaption></figcaption></figure></div>

**Step 3**\
The download job is added to a queue and a confirmation message is displayed:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FK2Tc4KOaXiZydK7Nukpj%2Fdownload%20run%20log%20confirmation.png?alt=media&amp;token=1d88d7c2-b1cd-492c-afa9-3c92f420e44e" alt=""><figcaption></figcaption></figure></div>

**Step 4**\
When your download is ready, you'll receive an email which includes a link to retrieve the file from the **file downloads** page. If you can't/don't want to use this link, you can access this page manually by selecting the **settings** option:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FMQogzR2C31P77eCnaFjf%2Fexport%20cross%20ref%20lookup%203.png?alt=media&amp;token=5ce09d36-e35e-40cb-9c2e-631ef1c3f82a" alt="" width="214"><figcaption></figcaption></figure></div>

...followed by the **file downloads** option:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FrBp9cEGmIsnOQe3D0vVX%2Fexport%20cross%20ref%20lookup%204.png?alt=media&amp;token=8f8a95d3-941b-480e-b4d4-3177f0844d28" alt="" width="563"><figcaption></figcaption></figure></div>

**Step 5**\
On the **file downloads** page, you'll find any exports that have been completed for your company profile in the last hour. Click the **download** button for your job:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        &#x20;

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FGaLpwUS0jjGKHwG6vqUk%2Fdownload%20run%20flow%20logs%203.png?alt=media&amp;token=c2e9ea9f-e25d-46b0-85fa-68e8f6f5615e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
This list may include exports from different parts of the dashboard, not just run logs (for example, [de-dupe](/product-documentation/~/changes/J8IbZkP6ASUZu2oBhGi2/process-flows/building-process-flows/process-flow-shapes/advanced-shapes/de-dupe-shape/importing-and-exporting-de-dupe-data.md) and [cross-reference lookup](/product-documentation/~/changes/J8IbZkP6ASUZu2oBhGi2/process-flows/cross-reference-lookups/importing-and-exporting-cross-reference-lookups.md) data exports are added here).
{% endhint %}

**Step 6**\
The associated CSV file is saved to the default downloads folder for your browser.

{% hint style="info" %}
Download files are cleared after one hour. If you don't manage to download your file within this time, don't worry - just download the logs again to create a new one.&#x20;
{% endhint %}