# How exports work

> What an export is, the One Time and Periodic types, the sixteen scopes, how the CSV is built and delivered, how schedules run, and what you can change after saving.

An **export** is a CSV file with the results of one kind of Releva element over a period, prepared in the background and e-mailed to the people you name. You manage exports under **Analytics › Exports**. The page title and breadcrumb call them **Reports**; the menu, the buttons and these docs call them exports.

## Two types

| Type         | When it runs                                   | What the period is                                                                                                                                  |
| ------------ | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **One Time** | Once, as soon as you save it                   | The **from** and **to** date-times you pick, in your local time                                                                                     |
| **Periodic** | At each scheduled time, while its switch is on | From one schedule interval before the run up to the run time: a weekly export run on Monday 08:00 covers the previous seven days up to Monday 08:00 |

A new Periodic export is saved **switched off**. Nothing is sent until you turn on the switch on its card. Turning it off later pauses it without losing the settings. See [Schedule a recurring export](https://releva.ai/documentation/guides/exports/schedule-a-recurring-export/).

## Scopes

The **Scope** picks the kind of element to export. The list has sixteen entries:

| Scope in the list                                                                                                                                                                                                                                                                    | What one row is                                   | Columns                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Recommenders** (this is **Personalization › Product Blocks**), **Banner Blocks**, **Banners**, **Campaigns**, **Emails**, **Push Notifications**, **Text Messages**, **Viber Messages**, **Segments**, **Facebook Ads**, **Catalog Triggers**, **Whatsapp Messages**, **Webhooks** | One item of that kind, plus a final **Total** row | **ID**, **Name**, then the item’s statistics for the period. Emails, for example, have **Sent**, **Sent (unique profiles)**, **Bounced**, **Complaints**, **Rejects**, **Unsubscribes (unique profiles)**, **Delivered**, **Delivered (unique profiles)**, **Opened**, **Opened (unique profiles)**, **Clicks**, **Clicks (unique profiles)**, **Assisted conversions**, **Assisted conversions (unique profiles)**, **Assisted purchases** and **Assisted revenue**; campaigns add **Goal hits** and **Goal hits (unique profiles)** for the campaign’s first goal; each kind has its own set |
| **Surveys**                                                                                                                                                                                                                                                                          | One survey submission                             | Profile, timestamp and the survey’s answers                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Nps Surveys**                                                                                                                                                                                                                                                                      | One NPS answer                                    | **Timestamp**, **Profile ID**, **First Name**, **Last Name**, **Email**, **Phone**, **Survey Name**, **Score**, **Category**, **Comment**                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Chat conversations**                                                                                                                                                                                                                                                               | One chat message                                  | **Session ID**, **Session started**, **Message time**, **Sender**, **Answer type**, **Message**, then the visitor’s **Visitor ID**, **Profile ID**, **Email**, **First name**, **Last name** and **Phone number**; this scope has no **Selection** and always covers every conversation in the period                                                                                                                                                                                                                                                                                          |

**Selection** decides whether the export covers **All** items of the scope or only the **Specific** ones you pick by name. For Emails, AI-generated emails are left out.

Four more kinds of export are created from other screens and appear in the same list with their own badge: a **profile** export from a segment (**Export Segment**, see [How segments work](https://releva.ai/documentation/learn/segments/how-segments-work/#counting-sampling-and-exporting)), an **event** export from **Data Platform › Events** (see [Export events](https://releva.ai/documentation/guides/events/export-events/)), a **product trends** export (see [Export a product trend](https://releva.ai/documentation/guides/product-trends/export-a-product-trend/)) and a **products** export of the ranked products of a product feed (**Export** on the feed’s card, see [Check how a product feed performs](https://releva.ai/documentation/guides/product-feeds/check-how-a-product-feed-performs/)). They are always One Time and are e-mailed to you.

## The Export shortcut on other pages

Most list and statistics pages that have a date-range picker also have an **Export** button next to it. It opens a **Create Export** window with the same form, prefilled: a One Time export for the page’s scope and date range, named `New <scope> export @ <time>`, with you as the recipient. On the details page of a single item the selection is already **Specific** with that item; on a list page it is **All**. Select **Create Export** to queue it; the notification says **Export Created** and the export is listed under **Analytics › Exports** like any other.

## How the file is built and delivered

1. Saving a One Time export, or a scheduled time for a Periodic one, creates an export run and queues it.
2. The run writes a UTF-8 CSV with a byte-order mark, so Excel opens it with the right characters. The file is named after the export, `<name>-export-<run id>.csv`, with Cyrillic letters transliterated and spaces replaced by dashes.
3. The file is uploaded to Releva’s export storage and every recipient gets an e-mail from Releva with the subject “Your \<scope> export is ready!” (for example “Your emails export is ready!”), the text “Your ‘\<name>’ export is ready.”, a **Download Export** button and, when the export has a period, “This export is based on data for the period between \<from> and \<to>.”
4. The e-mail ends with “The download link will be valid for 30 days after receipt of this e-mail.” Download the file within that time if you need to keep it.

Periods are half-open: the export counts data after **from** up to and including **to**. The dates are stored in UTC and the e-mail shows them in US format.

## How schedules run

* A schedule is **Every** n **week**s, **month**s or **year**s, on one or more **Day**s (weekdays for a week, a day of the month for a month, a day and a **Month** for a year), **at** a time. The time is taken in the time zone of the browser that saved the export; the card shows it with that UTC offset, for example **08:00 UTC+3**.
* Releva checks every switched-on Periodic export twice an hour, at :00 and :30, and runs those whose day, hour and minute match. Choose a time ending in :00 or :30; any other minute never matches.
* With **Every** above 1, a run on a given day is skipped while fewer than n intervals have passed since the last run on that day. Changing the time of day does not skip the next run.
* Each run is one file covering one interval. If the export was off at a scheduled time, that interval is not sent later.

## What you can change after saving

| Field                       | One Time | Periodic |
| --------------------------- | -------- | -------- |
| **Name**                    | yes      | yes      |
| **Type**                    | no       | no       |
| Period / **Schedule**       | no       | yes      |
| **Scope**                   | no       | no       |
| **Selection** and its items | no       | yes      |
| **Recipients**              | no       | yes      |

Open an export from the list to edit it; **Save** takes you back to the list. **Delete** asks **Are you sure?** with “This action cannot be undone!”; **Confirm** removes the export and its past runs (the files already sent stay valid until their link expires). Names must be unique per shop: a duplicate is refused with “Export name must be unique!”.

## Next steps

* [Export results for a date range](https://releva.ai/documentation/guides/exports/export-results-for-a-date-range/): Receive a CSV with the results of your emails, campaigns or other elements for a period you choose.
* [Schedule a recurring export](https://releva.ai/documentation/guides/exports/schedule-a-recurring-export/): Receive the same CSV every week, month or year.
* [Export events](https://releva.ai/documentation/guides/events/export-events/): Filter events and receive them as a file, with the custom fields you choose as columns.
* [Export a product trend](https://releva.ai/documentation/guides/product-trends/export-a-product-trend/): Receive up to 100 ranked products of one trend as a CSV.