> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Download data using the Data plugin

> Use the Data plugin to download data from Cognite Data Fusion to your local machine.

Use the `cdf data download` command to download data from Cognite Data Fusion (CDF) to your local machine. This command provides multiple subcommands for downloading different types of data, including raw tables, assets, time series, events, files, hierarchies, instances, and charts.

All subcommands have an interactive prompt if you do not specify any arguments, making it easy to select what you want to download.

## Prerequisites

Before downloading data, ensure you have:

* Installed and configured the Cognite Toolkit.
* Authenticated with CDF using appropriate credentials.
* Read permissions for the data you want to download.
* Sufficient disk space for the downloaded files.

## Download data

<Steps>
  <Step title="Run the interactive download">
    To download data interactively, run the command for your specific data type without arguments. For example, for **raw tables**:

    ```bash theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
    cdf data download raw
    ```

    Follow the prompts to select which raw tables you want to download.
  </Step>

  <Step title="Specify resources directly (optional)">
    Alternatively, you can specify the resources directly in the command line. For example, to download specific tables from a database:

    ```bash wrap theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
    cdf data download raw my_table1 my_table2 --database my_database
    ```
  </Step>
</Steps>

## Supported data types

The following data types are currently supported for download:

* Raw tables
* Assets
* Time series
* Events
* Files (with file content requires `extend-download` alpha flag enabled)
* Hierarchies (assets, events, time series, and files)
* Instances
* Charts
* Canvases
* Datapoints (requires `extend-download` alpha flag enabled)

For an up-to-date list of available data types and their arguments, use the `cdf data download --help` command.

## Further reading

* [Upload data using the Data plugin](/cdf/deploy/cdf_toolkit/guides/plugins/data_plugin/upload)
* [Purge data using the Data plugin](/cdf/deploy/cdf_toolkit/guides/plugins/data_plugin/purge)
* [Cognite Toolkit documentation](/cdf/deploy/cdf_toolkit)