> ## 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 Contacts

> Learn how to export contacts in ChatbotX to a CSV file containing Bot Fields, Custom Fields, and Tags, or automatically sync data to Google Sheets.

**Export Contacts** allows you to export your contact list from ChatbotX to external systems as a CSV file or record it automatically to Google Sheets. This helps you back up customer data (including Bot Fields, Custom Fields, and Tags) or use it for marketing campaigns.

## When to use Export Contacts

You should use the **Export Contacts** feature in the following scenarios:

* Backing up customer data for internal storage.
* Downloading contact lists with custom information like Custom Fields and Tags for data analysis.
* Transferring or syncing contact lists to CRM systems or other marketing tools.

## Exporting contacts directly via Actions

The **Export** action in the Contacts table allows you to quickly download a CSV file containing complete customer information.

<Steps>
  <Step title="Open the Contacts page">
    Go to the **Contacts** menu from the left sidebar.
  </Step>

  <Step title="Select the contacts to export">
    Select specific contacts or check the top checkbox in the list to select all contacts on the page. You can combine this with filters to select the exact target audience.
  </Step>

  <Step title="Choose the Export action">
    Click the **Actions** button at the top right of the table, then select **Export**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/Ny_Lbjd8EVhwnmSU/images/export-contacts.png?fit=max&auto=format&n=Ny_Lbjd8EVhwnmSU&q=85&s=aa87d839d672a19f2ecdd136aa93e8ee" alt="Export Contacts" width="2990" height="1402" data-path="images/export-contacts.png" />
    </Frame>
  </Step>

  <Step title="Download the CSV file">
    The **Export Contacts** window appears once the export file is ready. Click **Download** to download the CSV file containing customer details, including Bot Fields, Custom Fields, and Tags, or click **Copy link** to copy the download URL.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/Ny_Lbjd8EVhwnmSU/images/export-contacts-download.png?fit=max&auto=format&n=Ny_Lbjd8EVhwnmSU&q=85&s=020be8d49900835e37825cb1449e6a85" alt="Export Contacts Download" width="1788" height="1284" data-path="images/export-contacts-download.png" />
    </Frame>
  </Step>
</Steps>

## Exporting all data via Google Sheets

If you want to automatically record and sync contact information to an online spreadsheet in real time, use the Google Sheets integration combined with Sequences.

<Steps>
  <Step title="Connect your Google account">
    Go to **Settings > Integrations** and connect your Google account with ChatbotX.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/Ny_Lbjd8EVhwnmSU/images/connect_google_sheet.png?fit=max&auto=format&n=Ny_Lbjd8EVhwnmSU&q=85&s=6ea7f09137aa54012459a2065e34a40d" alt="Connect Google Sheet" width="2950" height="1315" data-path="images/connect_google_sheet.png" />
    </Frame>
  </Step>

  <Step title="Prepare your Google Sheets spreadsheet">
    Create a new spreadsheet in your Google Drive. Set up headers corresponding to the data you want to export (e.g., First Name, Last Name, Phone, Email, Custom Field...). Then, go to the Google Sheet Manage section in ChatbotX to add your newly created spreadsheet.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/mDmVup7U5LSTMeRi/images/google-sheet-manage.png?fit=max&auto=format&n=mDmVup7U5LSTMeRi&q=85&s=ff1313a24c678c96f09c48d79ebcd781" alt="Google Sheet Manage" width="2431" height="1254" data-path="images/google-sheet-manage.png" />
    </Frame>
  </Step>

  <Step title="Create an export Sequence">
    Go to **Sequences** in the left menu and create a new Sequence. Add a message or an action block for data export: select the **Action** block, choose **Google Sheets**, and configure the **Insert Row** action. Select your prepared spreadsheet and map the corresponding fields from ChatbotX to Google Sheets.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/Ny_Lbjd8EVhwnmSU/images/export-contacts-sequences.png?fit=max&auto=format&n=Ny_Lbjd8EVhwnmSU&q=85&s=e0c706c78b0c7c238ad90703a6ab4013" alt="Export Contacts Sequences" width="2983" height="1278" data-path="images/export-contacts-sequences.png" />
    </Frame>
  </Step>

  <Step title="Run bulk export via Add Sequence">
    Go back to the **Contacts** menu, filter, and select the contacts you want to export. Click **Actions > Add Sequence** and select the export Sequence you just created to automatically write the contact information to Google Sheets.
  </Step>
</Steps>

<Warning>
  Directly exported CSV files contain personal information and custom fields. Please keep them secure and avoid sharing them publicly to protect customer data.
</Warning>

<Note>
  When running the **Add Sequence** action to export data to Google Sheets for large lists, the system processes them sequentially. Please ensure your Sequence scenario is set to Active before running bulk actions.
</Note>
