directus/docs/user-guide/content-module/import-export.md

description, readTime

description	readTime
The Content, User Directory, and File Library modules allow importing and exporting of multiple Items stored as files.	4 min read

Import / Export

The Content, User Directory, and File Library modules allow importing and exporting of multiple Items stored as files. This makes it quick and easy to handle tasks like uploading and downloading new customer information; pulling down sales data for transformation, reports, analysis, and beyond.

::: tip Before You Begin

To use this utility, you will need to be familiar with Collections, Items, and Fields.

:::

::: tip Import / Export via the API

This page details Importing and Exporting of Items as files via the no-code app. However, you can also Import and Export Items as files programmatically via the API.

:::

Import Items

To import Items from a file, follow the steps below.

1. Navigate to the desired Module and Collection.
   Note: the User Directory and File Library are each composed of just one Collection.
2. Click "Import / Export" in the Sidebar.
3. Click into the import search box. A file browser will open.
4. Select the desired file and click "open".
5. Click "Start Import" to import the Items.

The Items will now be in the Collection. The file itself will not be stored in the Directus Project.

::: tip Importing Relational Files

It is possible to import relational Field values as well. For this task, the User performing the import will need access permissions for the related Collection and a firm understanding of the relational data model.

:::

Export Items

When exporting Items, the Export Items Menu provides granular control over exactly which Items and Fields are exported, how they are exported, and where they are exported. To export Items, follow the steps below.

1. Navigate to the desired Module and Collection.
   Note: the User Directory and File Library are each composed of one Collection.
2. Click "Import / Export" in the Sidebar.
3. Click "Export Items" and the Export Items Menu will appear.
4. Choose the desired format: CSV, JSON, XML, or YAML.
5. Optional: Configure any other export details as desired.
6. Click download to download the file.

::: tip Opening the file in Excel?

Export your file to CSV to seamlessly open in excel.

:::

::: tip Exporting to File Library

When downloading 2,500 or more Items, you will be required to download into the Directus Project's File Library. After exporting, go to the File Library to download your file locally.

:::

::: tip Exporting Relational Files

It is possible to export relational Field values. For this task, the User performing the export will need access permissions for the related Collection and a firm understanding of the relational data model.

:::

Export Items Menu

This menu provides granular control over exactly which Items and Fields are exported, how they are exported, and where they are exported.

• Format — Choose to export Items as CSV, JSON, XML, or YAML.
• Limit — Set the maximum number of Items to be exported.
• Export Location — Download the export file directly to your machine or to the File Library.
• Folder — Choose the Folder to download to (if export location is the Folder Library).
• Sort Field — Choose Field to sort Items by.
• Sort Direction — Choose to sort Items in ascending or descending order.
• Full-Text Search — Limit exported Items to ones which matched as search results.
• Filter — Limit exported Items with a Filter.
• Fields — Add, remove, and re-order the Item Fields that will be exported.

File Assets and Media

Some Collections may directly or relationally include Fields referencing images, videos or other file types. It is not possible to import or export files with this utility.

To import and export files, please see the File Library Module.

::: tip What does Import/Export do in the File Library?!

Import/Export handles Field Values associated with the file (e.g. id, title, description, etc.).

:::