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

# Export and Import Flows

> Export a ChatbotX Flow as a file, import it into a workspace, and track the result in Import history.

**Export** and **Import Flow** let you back up a Flow, move it to another workspace, or reuse an existing automation without rebuilding it from scratch.

<CardGroup cols={3}>
  <Card title="Export">
    Download the current Flow as a `.chatbotx-flow.json` file.
  </Card>

  <Card title="Import Flow">
    Add a Flow file to the workspace's Flows list.
  </Card>

  <Card title="Import history">
    Track the status and result of each import.
  </Card>
</CardGroup>

## Export a Flow

<Steps>
  <Step title="Open the Flow">
    Go to **Flows**, then open the Flow you want to back up or move to another workspace.
  </Step>

  <Step title="Open the Flow menu">
    In the Flow Builder, click the **three-dot** icon in the upper-right corner.
  </Step>

  <Step title="Select Export">
    Select **Export** to download the Flow. The exported filename ends with `.chatbotx-flow.json`.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/chatbotx/NBKD8ybvpSashSZq/images/flow_export_menu.png?fit=max&auto=format&n=NBKD8ybvpSashSZq&q=85&s=45d307587ba34f0f7f7275e19d36ba3d" alt="Flow Export Menu" width="3192" height="1825" data-path="images/flow_export_menu.png" />
</Frame>

## Import a Flow

<Steps>
  <Step title="Open the Flows list">
    Go to **Flows** in the workspace that will receive the Flow.
  </Step>

  <Step title="Select Import Flow">
    Click **Import Flow**, then select a `.chatbotx-flow.json` file exported from ChatbotX.
  </Step>

  <Step title="Track the import">
    ChatbotX processes the file and adds the Flow to the workspace. Click **Import history** to review the result.
  </Step>

  <Step title="Review the imported Flow">
    Open the new Flow, review its content and block connections, then click **Publish** when it is ready to use.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/chatbotx/aI5-2QvJBJUU7JpJ/images/flow_import_button.png?fit=max&auto=format&n=aI5-2QvJBJUU7JpJ&q=85&s=94f926ffe08931124566f19cda28f9df" alt="Import a Flow from the Flows page" width="2595" height="1664" data-path="images/flow_import_button.png" />
</Frame>

## Review Import history

The **Import history** page shows the result of each imported file:

* **Name**: The Flow filename.
* **Status**: The current processing status.
* **Progress**: The number of processed Flows compared with the total in the import.
* **Success**: The number of successfully imported Flows.
* **Failed**: The number of Flows that could not be imported.
* **Created At**: When the import started.
* **Completed at**: When processing finished.

For example, **Completed** with **Success** set to `1` and **Failed** set to `0` means that one Flow was imported successfully.

<Frame>
  <img src="https://mintcdn.com/chatbotx/aI5-2QvJBJUU7JpJ/images/flow_import_history.png?fit=max&auto=format&n=aI5-2QvJBJUU7JpJ&q=85&s=92f2f7c85081eb173a10f1a7bf3de83e" alt="Review Flow processing results in Import history" width="3187" height="672" data-path="images/flow_import_history.png" />
</Frame>

## Example workflow

Suppose you created a customer data collection Flow in your main workspace and want to reuse it in a new workspace:

1. Open the original Flow and select **Export**.
2. Switch to the new workspace, open **Flows**, and select **Import Flow**.
3. Open **Import history** to confirm that processing completed successfully.
4. Open the imported Flow, adjust its content for the new workspace, and click **Publish**.

<Note>
  Keep the `.chatbotx-flow.json` file if you want to use it as a backup or import the Flow into another workspace later.
</Note>