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

# Import contacts

> How to bulk import contacts from an Excel or CSV file, or sync them from Google Contacts

In this guide you'll learn how to bulk import your contacts into Mindo using an Excel or CSV file. You'll also see the other available options: manual entry and Google Contacts sync.

<iframe width="560" height="315" src="https://www.youtube.com/embed/eHRRucDV_lY" title="Tutorial: Import contacts in Mindo" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## Prerequisites

* An active Mindo account.
* Your contact list in an Excel (.xlsx, .xls) or CSV (.csv) file.
* Contacts must include at least **name** and **phone number** (with country code).

## Import from Excel/CSV

<Steps>
  <Step title="Go to the Contacts section">
    From the sidebar, click **Contacts** under the "Administration" section. You'll see your contacts list.
  </Step>

  <Step title="Click 'Añadir contactos'">
    In the upper right corner, click the **Añadir contactos** button. A dialog opens with three tabs:

    * **Manual**: to add contacts one by one.
    * **Excel/CSV**: to import from a file.
    * **Google Contacts**: to sync with your Google account.
  </Step>

  <Step title="Select the Excel/CSV tab">
    Click the **Excel/CSV** tab. Here you'll find:

    * **Descargar Plantilla** (Download Template): gives you an Excel file with the correct format and columns Mindo expects.
    * **Subir Archivo** (Upload File): the area where you drag or select your file.

    <Note>
      We recommend downloading the template first if this is your first import, so you can make sure the columns are in the correct format.
    </Note>
  </Step>

  <Step title="Upload your file">
    Drag your Excel or CSV file to the upload area, or click to select it from your computer. Once uploaded, you'll see the file name and the **Abrir vista previa** (Open preview) button.
  </Step>

  <Step title="Review the preview">
    Click **Abrir vista previa**. A table opens with all the data from your file where you can:

    * Check the **automatic column mapping** (Full name, Email, Phone, etc.).
    * Add a **phone prefix** if your numbers don't include one (e.g., +54).
    * Add an **origin detail** to identify where these contacts come from (e.g., "North Zone Clients").
    * **Edit data** directly in the table before importing.
    * **Delete rows** you don't want to import.

    <Warning>
      If a column wasn't mapped automatically, click the column selector to assign it to the correct field. You can choose from base fields and custom fields.
    </Warning>
  </Step>

  <Step title="Import the contacts">
    When everything is ready, click **Importar X contactos**. The contacts are created immediately and appear in your list with:

    * **Origin**: `csv_import`
    * **Origin Detail**: the name of the file you used.
  </Step>
</Steps>

## Other ways to add contacts

<AccordionGroup>
  <Accordion title="Manual entry">
    In the **Manual** tab of the "Añadir contactos" dialog you can add contacts one by one by filling in name, email, and phone.
  </Accordion>

  <Accordion title="Google Contacts">
    In the **Google Contacts** tab you can connect your Google account to import contacts automatically. The process has two steps:

    1. **Connect Google Contacts**: authorize Mindo to access your Google contact list.
    2. **Schedule daily import**: Mindo syncs your Google contacts every day automatically.
  </Accordion>
</AccordionGroup>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What file formats can I use?">
    You can use Excel (.xlsx, .xls) or CSV (.csv) files. The maximum size is 50 MB. Large files are processed in the background.
  </Accordion>

  <Accordion title="What columns does my file need?">
    The basic columns are: `full_name`, `email`, `phone`, and `wpp_phone` (WhatsApp phone). Name and phone are required.
  </Accordion>

  <Accordion title="What happens if a contact already exists?">
    Mindo uses the phone number to detect duplicates. If a contact with that phone number already exists, a new one is not created.
  </Accordion>

  <Accordion title="Can I edit data before importing?">
    Yes. In the preview you can edit any cell directly, delete rows you don't want to import, and adjust column mapping.
  </Accordion>

  <Accordion title="What is the 'Origin Detail' for?">
    It's an optional label that helps you remember where those contacts came from (e.g., "Expo Fair 2026", "South Zone Clients"). It's saved on each imported contact.
  </Accordion>

  <Accordion title="Can I import contacts without a country code?">
    Yes. In the preview there's a field to add a phone prefix (e.g., +54) to all numbers that don't have one.
  </Accordion>
</AccordionGroup>