# Export events to a file

> Filter Data Platform › Events, choose which custom fields become columns and receive the export file by e-mail.

Export the events of your shop to a file for analysis outside Releva. The export takes the filter you set on the **Events** page, includes every matching event (not only the current page) and e-mails a download link to you.

## Before you start

* The filtered list shows at least one event. The **Export** button only appears when the list is not empty.
* You can receive e-mail at the address you log in with. The download link goes to that address.
* You know which event custom fields you need as separate columns, if any.

## Steps

1. Go to **Data Platform › Events**.

   ![Step 1](https://releva.ai/documentation/_astro/step-1.DkOJog36_4k0QP.webp)

2. Optional. In **Filter by event action…**, type an event name and pick it. Set **From** and **to** to limit the time range.

   Without a filter the export contains every event of the last 30 days. Clear **From** to export all history.

   ![Step 2](https://releva.ai/documentation/_astro/step-2.DDKvdWq5_Z1kgVf0.webp)

3. Select **Export**.

   ![Step 3](https://releva.ai/documentation/_astro/step-3.B76btU8S_1ChN6O.webp)

4. **Export Events with Custom Fields** lists the event custom fields you can add as extra columns.

   The list shows every custom field (`custom.string.…`, `custom.numeric.…`, `custom.date.…`) that any event of your shop has used. Use **Search custom fields…** to find one, or **Select all**. Standard columns (name, e-mail, phone, action, order, timestamp and others) are always included.

   ![Step 4](https://releva.ai/documentation/_astro/step-4.DD3tDAot_Z2aVW32.webp)

5. Select the custom fields you want as separate columns.

   ![Step 5](https://releva.ai/documentation/_astro/step-5.CEW7sFvu_JL7dI.webp)

6. Select **Export with 1 custom field** (or **Export (standard fields only)** if you selected none). Releva e-mails you a download link.

   The button names how many fields you selected. After you confirm, the button on the Events page reads **Export scheduled. Please check your email for a download link.**

   ![Step 6](https://releva.ai/documentation/_astro/step-6.DKGDeqSs_Z1JS5zj.webp)

## Check it worked

* The **Export** button is replaced by **Export scheduled. Please check your email for a download link.**
* An e-mail with a download link arrives at your login address once the file is ready.
* The file has one row per event in your filter and one extra column per custom field you selected.

## Troubleshooting

**There is no Export button.** The list is empty. Widen the filter: clear the event action, or clear **From** to include older events.

**The modal says “No custom fields found for events. The export will include standard columns only.”** No event of your shop has carried a custom field yet. You can still export the standard columns.

**The export contains fewer events than the page title says.** The export leaves out events of profiles that were deleted. The on-screen count includes them.

**No e-mail arrived.** The file is built in the background and can take a while for large ranges. Check your spam folder. The export is also listed with your shop’s other exports; ask your account owner if it is missing there.

## Next steps

* [Check that an event reached Releva](https://releva.ai/documentation/guides/events/check-that-an-event-reached-releva/): Filter by event action and read the raw event to confirm it was stored with the right data.
* [See all events of a customer](https://releva.ai/documentation/guides/events/see-all-events-of-a-customer/): Open the profile behind an event to see everything Releva tracked for that customer.
* [Events API overview](https://releva.ai/documentation/reference/events/overview/): Read events from your own system through the API instead of a file.