mirror of
https://github.com/directus/directus.git
synced 2026-01-28 11:58:11 -05:00
133 lines
5.1 KiB
Markdown
133 lines
5.1 KiB
Markdown
---
|
|
description:
|
|
The Content, User Directory, and File Library modules allow importing and exporting of multiple Items stored as files.
|
|
readTime: 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](/getting-started/glossary#collections),
|
|
[Items](/getting-started/glossary#items), and [Fields](/getting-started/glossary#fields).
|
|
|
|
<!--
|
|
@TODO Getting Started > Introduction
|
|
Link when ready
|
|
-->
|
|
|
|
:::
|
|
|
|
:::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](/reference/system/utilities#import-data-from-file) and
|
|
[Export](/reference/system/utilities#export-data-to-a-file) Items as files programmatically via the API.
|
|
|
|
:::
|
|
|
|
## Import Items
|
|
|
|
<video autoplay playsinline muted loop controls title="Import Data From a File">
|
|
<source src="https://cdn.directus.io/docs/v9/app-guide/imports-exports/imports-exports-20220415A/import-items-20220416A.mp4" type="video/mp4" />
|
|
</video>
|
|
|
|
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.
|
|
|
|
<!--
|
|
@TODO config > import / export
|
|
Add link
|
|
-->
|
|
|
|
:::
|
|
|
|
## Export Items
|
|
|
|
<video autoplay playsinline muted loop controls title="Export Data to a File">
|
|
<source src="https://cdn.directus.io/docs/v9/app-guide/imports-exports/imports-exports-20220415A/export-items-20220416A.mp4
|
|
" type="video/mp4" />
|
|
</video>
|
|
|
|
When exporting Items, the [Export Items Menu](#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](#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 <span mi btn>download</span> 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.
|
|
|
|
<!--@TODO link to config access permissions when ready-->
|
|
|
|
:::
|
|
|
|
## Export Items Menu
|
|
|
|
<video autoplay playsinline muted loop controls title="Export Data to a File">
|
|
<source src="https://cdn.directus.io/docs/v9/app-guide/imports-exports/imports-exports-20220415A/export-items-menu-20220416A.mp4" type="video/mp4" />
|
|
</video>
|
|
|
|
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](/app/file-library).
|
|
|
|
:::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.)_.
|
|
|
|
:::
|