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

# Import and export pipelines

You can export and import pipelines to copy them between projects. **Export** copies the pipeline definition to a zipped data file in your local filesystem. You can then use the **Import** function to import that data into another project. You can also export and import an entire pipeline folder, including all the pipelines and subfolders it contains, or the entire project including all folders and pipelines within it.

There is a limit on the size of the pipeline you want to import:

* Maximum compressed size: Fails if import exceeds 8 MB.
* Maximum decompressed size: Fails if import exceeds 100 MB.
* Maximum file size: Fails if any individual file exceeds 5 MB.
* Maximum files: Fails if import exceeds 2500 files.

***

## Exporting a pipeline

To export a pipeline, folder, or project, hover over its name in the **Files** panel, click the three dots **...** that appear next to it, and then click **Export**.

When you export a pipeline, folder, or project, it is exported as a `.zip` file containing all the exported pipeline definitions in `.yaml` format. If you export a folder or project, the `.zip` file preserves the structure of the files and folders it contains. The file is exported to your local default download location. The name of the `.zip` file is in the format `<project name>_<branch>_<file/folder name>_<yyyymmdd>T<hhmmss>.zip`, which creates a unique name for each export.

The `.zip` file contains everything required to recreate the exported pipelines in a new project, including component property values, pipeline variables, component connections, and canvas notes. It does *not* include project-level configurations such as schedules, secrets, OAuths, and project variables. Make sure that you configure these in the target project before running the imported pipeline.

The export captures the current state of all exported pipelines as they exist in Designer at the time they are exported. Since Designer automatically saves your pipelines while you work, the export captures all changes made to exported pipelines, including uncommitted changes.

***

## Importing a pipeline

> [!NOTE]
>
> A pipeline can only be imported if the importing user has the same [role permissions](https://docs.maia.ai/docs/administration/project-roles.md) as the user who exported it.

1. In the **Files** panel, click the **+** icon and click **Import**, or hover over the folder that you want to import into, click the three dots **...** that appear next to it, and click **Import**.
2. Browse your filesystem to locate the exported `.zip` file that you want to import, select the file, and click **Open**.

The pipelines contained in the `.zip` file are imported to the selected pipeline folder. If you import a pipeline folder or an entire project, it forms a subfolder of the folder you are importing into.

> [!WARNING]
>
> You can't import a `.zip` file into a folder if those files already exist in the folder you are importing into. If you try this, you will receive an error stating `Import unsuccessful: The files you tried to import already exist`.

***

## Importing a pipeline from Matillion Exchange

Pre-built Maia pipelines are available from [Matillion Exchange](https://exchange.matillion.com/data-productivity-cloud/pipeline/). To import a pipeline or set of pipelines from Matillion Exchange into Maia:

1. In the **Files** panel, click the **+** icon, then click **Browse Exchange**.
2. In the **Browse Exchange** panel that opens on the right of the canvas, search for and click the pipeline or set of pipelines that you want to import.

> [!NOTE]
>
> Click **Learn more** on one of the pipeline tiles to open Matillion Exchange and find more details about the corresponding pipeline or set of pipelines.

Your chosen pipelines are added to a new folder called **Imported from Exchange**. Each pipeline or set of pipelines that you import from Matillion Exchange is added to a subfolder inside this one.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.