# How to Export Audiences ### About this export | Field | Value | | --- | --- | | **content_type** | lesson | | **platform** | contentstack-academy | | **source_url** | https://www.contentstack.com/academy/courses/use-cases-and-tutorials/how-to-export-audiences | | **course_slug** | use-cases-and-tutorials | | **lesson_slug** | how-to-export-audiences | | **markdown_file_url** | /academy/md/courses/use-cases-and-tutorials/how-to-export-audiences.md | | **generated_at** | 2026-04-28T06:55:49.947Z | > Part of **[Use Cases and Tutorials](https://www.contentstack.com/academy/courses/use-cases-and-tutorials)** on Contentstack Academy. **Academy MD v3** — structured for retrieval; no quiz or assessment keys. #### Video details #### At a glance - **Title:** How To Export Audiences - **Duration:** 3m 28s - **Media link:** https://cdn.jwplayer.com/previews/ZGeJlubB - **Publish date (unix):** 1751779823 #### Streaming renditions - application/vnd.apple.mpegurl - audio/mp4 · AAC Audio · 113595 kbps - video/mp4 · 180p · 200p · 154498 kbps - video/mp4 · 270p · 300p · 185183 kbps - video/mp4 · 360p · 400p · 211364 kbps - video/mp4 · 406p · 450p · 226698 kbps - video/mp4 · 540p · 600p · 286968 kbps #### Timed text tracks (delivery) - **thumbnails:** `https://cdn.jwplayer.com/strips/ZGeJlubB-120.vtt` #### Transcript Hello, today we will export an audience as a CSV file via SFTP. The first step in this process is to go to the Audience tab, select an audience you would like to export, and then on the right-hand side, there's a green Export button, which you can click. To export an audience via SFTP, you need to use the custom integration style, and you will see the Export CSV via SFTP option here. Select an authorization you would like to use, I already have one set up, and you can add a label, which will be the title of the job, and a description for more details. We already have the audience name set up. You have the option to compress the file, and there are some more configurations. Here, you can select specific fields to export. If none are selected, then every single user field will be included in that export. Next you can choose how many users you want to see in the exported CSV for that audience. If you leave it blank, everyone will export. You have the option to change the custom delimiter, and many other options to choose from. Should you need more information about any of these configurations, you can go to Learn Analytics, search for Custom Integrations, and find the CSV export option, and all the details can be found here. I'm going to leave everything with the default settings, and click on Start Export. As soon as you see this green box in the left-hand corner, Successfully Started the Job, you know that the job is now started and running. You're able to look into the details of your export. This is a way to review which configurations you selected, including the audience you selected. There's also a Logs tab that will let you know how that export is processing. And that is one way to export an audience via SFTP in Lytx. Thank you, and I hope you enjoyed this recording. #### Subtitles (WebVTT) ```webvtt WEBVTT 1 00:00:00.000 --> 00:00:08.160 Hello, today we will export an audience as a CSV file via SFTP. 2 00:00:08.160 --> 00:00:14.600 The first step in this process is to go to the Audience tab, select an audience you would 3 00:00:14.600 --> 00:00:20.380 like to export, and then on the right-hand side, there's a green Export button, which 4 00:00:20.380 --> 00:00:25.320 you can click. 5 00:00:25.320 --> 00:00:32.480 To export an audience via SFTP, you need to use the custom integration style, and you 6 00:00:32.480 --> 00:00:39.240 will see the Export CSV via SFTP option here. 7 00:00:39.240 --> 00:00:47.480 Select an authorization you would like to use, I already have one set up, and you can 8 00:00:47.840 --> 00:00:54.840 add a label, which will be the title of the job, and a description for more details. 9 00:00:54.840 --> 00:01:01.840 We already have the audience name set up. 10 00:01:16.120 --> 00:01:23.120 You have the option to compress the file, and there are some more configurations. 11 00:01:23.440 --> 00:01:28.240 Here, you can select specific fields to export. 12 00:01:28.240 --> 00:01:35.240 If none are selected, then every single user field will be included in that export. 13 00:01:37.760 --> 00:01:44.760 Next you can choose how many users you want to see in the exported CSV for that audience. 14 00:01:44.760 --> 00:01:51.100 If you leave it blank, everyone will export. 15 00:01:51.100 --> 00:01:57.380 You have the option to change the custom delimiter, and many other options to choose 16 00:01:57.380 --> 00:01:58.700 from. 17 00:01:58.700 --> 00:02:02.580 Should you need more information about any of these configurations, you can go to Learn 18 00:02:02.580 --> 00:02:09.580 Analytics, search for Custom Integrations, and find the CSV export option, and all the 19 00:02:14.740 --> 00:02:20.780 details can be found here. 20 00:02:20.820 --> 00:02:27.820 I'm going to leave everything with the default settings, and click on Start Export. 21 00:02:31.780 --> 00:02:37.140 As soon as you see this green box in the left-hand corner, Successfully Started the Job, you 22 00:02:37.140 --> 00:02:44.140 know that the job is now started and running. 23 00:02:45.140 --> 00:02:52.140 You're able to look into the details of your export. 24 00:02:54.900 --> 00:03:01.900 This is a way to review which configurations you selected, including the audience you selected. 25 00:03:02.900 --> 00:03:09.900 There's also a Logs tab that will let you know how that export is processing. 26 00:03:13.900 --> 00:03:20.900 And that is one way to export an audience via SFTP in Lytx. 27 00:03:21.900 --> 00:03:26.900 Thank you, and I hope you enjoyed this recording. ``` ```transcript [00:00] Hello, today we will export an audience as a CSV file via SFTP. [00:08] The first step in this process is to go to the Audience tab, select an audience you would [00:14] like to export, and then on the right-hand side, there's a green Export button, which [00:20] you can click. [00:25] To export an audience via SFTP, you need to use the custom integration style, and you [00:32] will see the Export CSV via SFTP option here. [00:39] Select an authorization you would like to use, I already have one set up, and you can [00:47] add a label, which will be the title of the job, and a description for more details. [00:54] We already have the audience name set up. [01:16] You have the option to compress the file, and there are some more configurations. [01:23] Here, you can select specific fields to export. [01:28] If none are selected, then every single user field will be included in that export. [01:37] Next you can choose how many users you want to see in the exported CSV for that audience. [01:44] If you leave it blank, everyone will export. [01:51] You have the option to change the custom delimiter, and many other options to choose [01:57] from. [01:58] Should you need more information about any of these configurations, you can go to Learn [02:02] Analytics, search for Custom Integrations, and find the CSV export option, and all the [02:14] details can be found here. [02:20] I'm going to leave everything with the default settings, and click on Start Export. [02:31] As soon as you see this green box in the left-hand corner, Successfully Started the Job, you [02:37] know that the job is now started and running. [02:45] You're able to look into the details of your export. [02:54] This is a way to review which configurations you selected, including the audience you selected. [03:02] There's also a Logs tab that will let you know how that export is processing. [03:13] And that is one way to export an audience via SFTP in Lytx. [03:21] Thank you, and I hope you enjoyed this recording. ``` #### Lesson text Learn how to export audiences as a CSV for custom integrations. ## Exporting Audiences via CSV ### Introduction **Note:** On January 10, 2023, we upgraded our UI with a new, refreshed interface. All of the underlying functionality is the same, but you will notice that things look a little different from this Academy guide. The most notable change is that the navigation menu has moved from the top of the app to the left side. We appreciate your patience as we work on updating our Academy. In this tutorial, we'll introduce how to export audiences from Lytics to external sources, using the Lytics **Custom Integration** for **SFTP** and **Email exports**.  * How to export a CSV from the Audiences section of the UI * How to export a CSV from the Jobs section of the UI This option is recommended when debugging or exporting to third-party systems that do not have a direct integration with Lytics. Custom exports can be made via **CSV**. There are many **out-of-the-box integrations** to run export jobs from Lytics to external sources, this is just one. The basic principles described in the following sections are standard when using any one of our integrations. Find the full list of supported integrations on [Learn Lytics](https://learn.lytics.com/documentation/product/integrations). ### Video Tutorial Watch the "How to Export Audiences" video (3.5 mins) for a walk through of how to export an audience as a CSV from the audiences tab in Lytics. **If no fields are selected to export in the configuration, then ALL user fields will be included.** A. True B. False Answer: True **Which of the following are configuration options?** A. User limit B. File compression C. Custom delimiter D. All of the above E. None of the above Answer: D ### Start a New Export Now we'll show another way you can export audiences via CSV starting from the Jobs section of the Lytics UI. 1. In your Lytics account, navigate to [Data > Jobs](https://app.lytics.com/data/jobs) and click the **Create New Job** button in the upper right corner. ![Create-new-job.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt4aedb5737bafb9a1/686a16b3177f44139363fcd6/Create-new-job.png) 2. Select the integration tile (use the search bar at the top for faster results). In this example we will select **Custom Integrations,** which will export CSV data to either an email address or to a SFTP account. ![select-Custom-Integrations.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt611e835ffd27eb10/686a16b3177f4405a263fcd2/select-Custom-Integrations.png) ### Authorize Custom Export 1. Under the Export options select **CSV via SFTP**. ![Select Export > CSV via SFTP.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte5cba6c590c0ad1b/686a5299966f7996ca008274/Select_Export_CSV_via_SFTP.png) 2. If an authorization for an SFTP account has not been established or you do not have access to the SFTP authorizations listed to extract the file, click the **Create New Authorization** button.  3. When setting up a new authorization there are several options. In this case we will create a **Lytics Managed SFTP Server Authorization** which will generate an SFTP account you can access via an external SFTP tool. ![create-authorization-sftp-csv-export.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt6a91170481357b06/686a5348a795875647f50cf8/create-authorization-sftp-csv-export.png) 4. Fill out the label and Description with meaningful detail and create a username and password. Remember the username and password since you will need this to access the SFTP account via FTP client. **Do you need to have an authorization setup for a Custom Export to a SFTP instance?** A. Yes B. No Answer: A ### Configure Export 1. After a SFTP Server Authorization has been created, you can use this for more exports as needed. 2. The last step is to configure the job to export an audience. Depending on the needs such as a **one-time export** or **continuous export,** the job will have to be set up differently. Please see our [Custom Integrations: CSV Export](https://learn.lytics.com/documentation/product/integrations/custom-integrations/csv-export#custom-integrations:-csv-export) documentation for all configuration options. ![configure job to export an audience.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltc790d335291fe6ca/686a595d03043fdbd4fbfd66/configure_job_to_export_an_audience.png) If you select the **continuous export** option, you have three options for how often to export the file: **daily, weekly, or monthly.**![continuous-export-option.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltfb2b21793bc05ad6/686a595dc3d87be192b6e7b8/continuous-export-option.png) **You can export new files continuously on a \_\_\_\_\_ basis. Select all that apply.** A. Hourly B. Daily C. Weekly D. Monthly Answer: B, C, D ### Export Results 1. Once the export has been completed, it will sit in the job queue list under **Data > Jobs**, where you can see its current status. ![Export in job queue under Data > Jobs.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt1cad04a237d1e8b1/686a5b8e4b4fe90a835c4a04/Export_in_job_queue_under_Data_Jobs.png) 2. Once the audience export is ready the status will be **Completed** in the Jobs section and you can go to an FTP client and access the data.  Simply add the host name (**sftp.lytics.io**),  port number (**22**), user name , and password . ![Audience Export Demo modal.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt994233a2b08b96b4/686a5b8ec4493caa75a97885/Audience_Export_Demo_modal.png) Thanks for completing this tutorial on how to export audiences as a CSV. Below are recommended resources to continue learning. ### Academy Courses * Connecting Integrations * Jobs and Authorizations ### Documentation * [CSV Export documentation](https://learn.lytics.com/documentation/product/integrations/custom-integrations/csv-export) #### Key takeaways - Connect **How to Export Audiences** back to your stack configuration before moving to the next module. - Capture one concrete artifact (screenshot, Postman call, or code snippet) that proves the step works in your environment. - Re-read the delivery versus management boundary for anything you changed in the entry model. ## Supplement for indexing ### Content summary How to Export Audiences. Learn how to export audiences as a CSV for custom integrations. Exporting Audiences via CSV Introduction Note: On January 10, 2023, we upgraded our UI with a new, refreshed interface. All of the underlying functionality is the same, but you will notice that things look a little different from this Academy guide. The most notable change is that the navigation menu has moved from the top of the app to the left side. We appreciate your patience as we work on updating our Academy. In this tutorial, we'll introduce how to export audiences from Lytics to external sources, using the Lytics Custom Integration for SFTP and Email exports . How to export a CSV from the Audiences section of the UI How t ### Retrieval tags - How - Export - Audiences - use-cases-and-tutorials - lesson 07 - How to Export Audiences - use-cases-and-tutorials lesson ### Indexing notes Index this lesson as a primary chunk tagged with lesson_id "07" and topics: [How, Export, Audiences]. Parent course slug: use-cases-and-tutorials. Use asset_references URLs as thumbnail hints in search results when present. Never surface LMS quiz content or assessment answers from this file. ### Asset references | Label | URL | | --- | --- | | Video thumbnail: How to Export Audiences | `https://cdn.jwplayer.com/v2/media/ZGeJlubB/poster.jpg?width=720` | | Create-new-job.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt4aedb5737bafb9a1/686a16b3177f44139363fcd6/Create-new-job.png` | | select-Custom-Integrations.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt611e835ffd27eb10/686a16b3177f4405a263fcd2/select-Custom-Integrations.png` | | Select Export > CSV via SFTP.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte5cba6c590c0ad1b/686a5299966f7996ca008274/Select_Export_CSV_via_SFTP.png` | | create-authorization-sftp-csv-export.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt6a91170481357b06/686a5348a795875647f50cf8/create-authorization-sftp-csv-export.png` | | configure job to export an audience.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltc790d335291fe6ca/686a595d03043fdbd4fbfd66/configure_job_to_export_an_audience.png` | | continuous-export-option.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltfb2b21793bc05ad6/686a595dc3d87be192b6e7b8/continuous-export-option.png` | | Export in job queue under Data > Jobs.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt1cad04a237d1e8b1/686a5b8e4b4fe90a835c4a04/Export_in_job_queue_under_Data_Jobs.png` | | Audience Export Demo modal.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt994233a2b08b96b4/686a5b8ec4493caa75a97885/Audience_Export_Demo_modal.png` | ### External links | Label | URL | | --- | --- | | Contentstack Academy home | `https://www.contentstack.com/academy/` | | Training instance setup | `https://www.contentstack.com/academy/training-instance` | | Academy playground (GitHub) | `https://github.com/contentstack/contentstack-academy-playground` | | Contentstack documentation | `https://www.contentstack.com/docs/` | | Learn Lytics | `https://learn.lytics.com/documentation/product/integrations` | | Data > Jobs | `https://app.lytics.com/data/jobs` | | Create-new-job.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt4aedb5737bafb9a1/686a16b3177f44139363fcd6/Create-new-job.png` | | select-Custom-Integrations.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt611e835ffd27eb10/686a16b3177f4405a263fcd2/select-Custom-Integrations.png` | | Select Export > CSV via SFTP.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte5cba6c590c0ad1b/686a5299966f7996ca008274/Select_Export_CSV_via_SFTP.png` | | create-authorization-sftp-csv-export.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt6a91170481357b06/686a5348a795875647f50cf8/create-authorization-sftp-csv-export.png` | | Custom Integrations: CSV Export | `https://learn.lytics.com/documentation/product/integrations/custom-integrations/csv-export#custom-integrations:-csv-export` | | configure job to export an audience.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltc790d335291fe6ca/686a595d03043fdbd4fbfd66/configure_job_to_export_an_audience.png` | | continuous-export-option.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltfb2b21793bc05ad6/686a595dc3d87be192b6e7b8/continuous-export-option.png` | | Export in job queue under Data > Jobs.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt1cad04a237d1e8b1/686a5b8e4b4fe90a835c4a04/Export_in_job_queue_under_Data_Jobs.png` | | Audience Export Demo modal.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt994233a2b08b96b4/686a5b8ec4493caa75a97885/Audience_Export_Demo_modal.png` | | CSV Export documentation | `https://learn.lytics.com/documentation/product/integrations/custom-integrations/csv-export` |