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

# Upload Contacts

> Import your contacts via CSV file

## Upload Process

<Steps>
  <Step title="Choose Contact Type">
    Select whether to upload:

    * Attendees
    * Promoters
  </Step>

  <Step title="Download Template">
    Get our CSV template with required fields:

    * Name
    * Email

    <Card title="Download CSV Template" icon="file-csv">
      [Download Template](/templates/contacts-template.csv)
    </Card>
  </Step>

  <Step title="Prepare Your CSV">
    Follow these guidelines:

    * Use supported headings (Name & Email)
    * Fill out all required fields
    * Save file as CSV format

    <Warning>
      Double check red boxes in the Import Preview to ensure all required fields are filled out.
    </Warning>
  </Step>

  <Step title="Upload File">
    1. Click "Upload CSV" button
    2. Select your prepared file
    3. Review import preview
    4. Select contacts using checkboxes
    5. Click "Import Selected" button
  </Step>
</Steps>

## CSV Requirements

<AccordionGroup>
  <Accordion icon="table" title="Required Fields">
    Your CSV must include:

    * **Name**: Full name or first name
    * **Email**: Valid email address
  </Accordion>

  <Accordion icon="circle-check" title="Best Practices">
    For best results:

    * Use our template
    * Check for formatting errors
    * Verify email addresses
    * Remove duplicates
  </Accordion>

  <Accordion icon="triangle-exclamation" title="Common Issues">
    Avoid these problems:

    * Missing required fields
    * Incorrect column headers
    * Invalid email formats
    * Special characters
  </Accordion>
</AccordionGroup>

## Import Preview

Before finalizing the import:

* Review contact information
* Check for any errors (highlighted in red)
* Select contacts to import
* Verify total count

<Note>
  Make sure to select all desired contacts using the checkboxes before uploading.
</Note>

<Warning>
  Uploading duplicate contacts will update existing records rather than create duplicates.
</Warning>