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

# How to import your data into Affinity

> Help center reference: How to import data into Affinity

<Note>
  **How-to** — task-oriented recipe.
</Note>

Given that your Excel/CSV files can have different formats, please make sure to clean up and properly format your data before starting the import process (see [Cleaning up your data before importing into Affinity](/s/article/Cleaning-up-your-data-before-importing-into-Affinity)). Once you do so, feel free to proceed with this video walkthrough:

<iframe src="https://player.vimeo.com/video/751462165" title="Vimeo video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

**Note**: This video contains the old navigation bar on the top, whereas the current navigation bar now lies on the left side of your screen. While the remaining content is still the same, rest assured that we will be updating our videos accordingly.

## 1. Uploading your CSV file onto an Affinity list

1. Once you've [cleaned up your CSV file](/s/article/Cleaning-up-your-data-before-importing-into-Affinity), click into the list you plan to import into. For this example, we will import into an organization list.
2. Click **List Options** on the top-right corner, then click **Import data**.

<img src="https://mintcdn.com/support-affinity/gNHMiKP2aDiIOSeo/images/admin-data-migration/how-to-import-data-into-affinity/1.jpg?fit=max&auto=format&n=gNHMiKP2aDiIOSeo&q=85&s=71070ecf8c82b37180602926703152e6" alt="" width="1626" height="385" data-path="images/admin-data-migration/how-to-import-data-into-affinity/1.jpg" />

3. Make sure to read through all bullet points to ensure the data in your CSV file are formatted correctly, then click the checkbox to confirm you've reviewed your CSV file.

<img src="https://mintcdn.com/support-affinity/gNHMiKP2aDiIOSeo/images/admin-data-migration/how-to-import-data-into-affinity/2.jpg?fit=max&auto=format&n=gNHMiKP2aDiIOSeo&q=85&s=31254882937820b106a6946c68c67282" alt="" width="1330" height="836" data-path="images/admin-data-migration/how-to-import-data-into-affinity/2.jpg" />

4. Drag and drop or browse for a CSV file, then click **Continue**.

<img src="https://mintcdn.com/support-affinity/gNHMiKP2aDiIOSeo/images/admin-data-migration/how-to-import-data-into-affinity/3.jpg?fit=max&auto=format&n=gNHMiKP2aDiIOSeo&q=85&s=7f4e1ba9127dbb56b17ffad7212840ee" alt="" width="1173" height="817" data-path="images/admin-data-migration/how-to-import-data-into-affinity/3.jpg" />

5. Receiving an error message when trying to upload your CSV file? You can refer back to the common troubleshooting tips found in the section titled "Other Important Callouts" within this article: [Cleaning up your data before importing into Affinity](/s/article/Cleaning-up-your-data-before-importing-into-Affinity)

<img src="https://mintcdn.com/support-affinity/gNHMiKP2aDiIOSeo/images/admin-data-migration/how-to-import-data-into-affinity/4.jpg?fit=max&auto=format&n=gNHMiKP2aDiIOSeo&q=85&s=6d375a06098a4be47b73949de0de3501" alt="" width="1175" height="804" data-path="images/admin-data-migration/how-to-import-data-into-affinity/4.jpg" />

## 2. Choosing your preferred import option

Once you've successfully uploaded the CSV file, select one of the following import options:

1. **Add new values from the CSV file to existing contacts:**
   * This will add any additional values to a field if it is a multi-value field.
   * If it is a single value field, we will add the values if the cell is empty, but skip if the cell already contains a value.
2. **Create duplicate entries of contacts in your Affinity list:**
   * This will create a new entry for every imported row.
3. **Skip duplicate entries of contacts from the CSV file:**
   * This will skip any rows from your CSV file that already exist on the list.
   * For example, if Company A is on Row 4 in your CSV file and Company A is an entry on your Affinity list, then Row 4 will be skipped entirely and Company A on the Affinity list will remain untouched.
   * **Tip:** This option is useful when you're importing data from another source frequently and only want to add new companies to your list and not update any existing ones.
4. **Overwrite existing values with values from the CSV file:**
   * This will overwrite all cells in Affinity with the ones you import from your CSV file.

For this example, we only want to add new values from the CSV file, so we will choose to **Add new values from the CSV file to existing contacts**, then click **Next**.

<img src="https://mintcdn.com/support-affinity/qXiXgl2ilNHkDikt/images/admin-data-migration/how-to-import-data-into-affinity/import-data-1.jpeg?fit=max&auto=format&n=qXiXgl2ilNHkDikt&q=85&s=f5ea12ddc234fb246492a6d1ea284fd9" alt="Import Data 1" title="Import Data 1" style={{ width:"93%" }} width="1181" height="762" data-path="images/admin-data-migration/how-to-import-data-into-affinity/import-data-1.jpeg" />

## 3. Mapping the primary fields

1. Map the **Website** column from the CSV file to the **Website** field in Affinity (required since the **Website** is the unique identifier when matching organizations from your CSV file to the organizations already existing in your account).
   * For People lists, the unique identifier would be the **Email Address** column from the CSV file.
   * For Opportunity lists, the unique identifier would be the **Opportunity Name** from the CSV file.

<img src="https://mintcdn.com/support-affinity/gNHMiKP2aDiIOSeo/images/admin-data-migration/how-to-import-data-into-affinity/5.jpg?fit=max&auto=format&n=gNHMiKP2aDiIOSeo&q=85&s=a205fbd9d575d1874a9cc9112c97d2f8" alt="" width="2308" height="1500" data-path="images/admin-data-migration/how-to-import-data-into-affinity/5.jpg" />

2. Map the **Organization Name** column from your CSV file to the **Organization Name** field in Affinity (the **Organization Name** is required when importing into organization lists).
   * The **Full Name** column from the CSV file is required when importing into people lists.
   * The **Opportunity Name** column from the CSV file is required when importing into opportunity lists.

<img src="https://mintcdn.com/support-affinity/gNHMiKP2aDiIOSeo/images/admin-data-migration/how-to-import-data-into-affinity/6.jpg?fit=max&auto=format&n=gNHMiKP2aDiIOSeo&q=85&s=f90bcfd7348476568a42541cbdfe7e41" alt="" width="2358" height="1526" data-path="images/admin-data-migration/how-to-import-data-into-affinity/6.jpg" />

## 4. Mapping the remaining fields

Now that we have determined which specific organizations to import data into, map the rest of the columns from the CSV file to the relevant Affinity field.

<img src="https://mintcdn.com/support-affinity/gNHMiKP2aDiIOSeo/images/admin-data-migration/how-to-import-data-into-affinity/7.jpg?fit=max&auto=format&n=gNHMiKP2aDiIOSeo&q=85&s=9829ee8c8ca5ab7b2d7d6749625ba8f4" alt="" width="2344" height="1514" data-path="images/admin-data-migration/how-to-import-data-into-affinity/7.jpg" />

1. Select the relevant Affinity Field for each CSV column by clicking on the dropdown. You can also type the name of the column you are looking for after clicking on the dropdown.
2. Please note, some fields will be auto-mapped for your convenience, but we will not auto-map to people-type, organization-type, and location-type fields since they require multiple fields to map to specific attributes:
   1. Person - Full Name, Email Address
   2. Organization - Name, Domain
   3. Location - City, Address, Country
3. If there are any **global fields** that you are mapping to, you will be asked which method you'd like to choose for updating global fields. Feel free to refer back to the explanations found in Section: 2. Choosing your preferred import option.
   <img src="https://mintcdn.com/support-affinity/qXiXgl2ilNHkDikt/images/admin-data-migration/how-to-import-data-into-affinity/import-data-2.jpeg?fit=max&auto=format&n=qXiXgl2ilNHkDikt&q=85&s=7f30e2b3ce6c2991f30d87ab68fe0fc4" alt="Import Data 2" title="Import Data 2" style={{ width:"64%" }} width="848" height="617" data-path="images/admin-data-migration/how-to-import-data-into-affinity/import-data-2.jpeg" />
4. Now, **remove** any columns from your CSV that you don't want to upload by clicking on the **Trash icon**.
5. Use the **Backspace** button on your keyboard to remove a selection from the dropdown.
6. Once you're finished mapping, click **Begin import**.

Please note that you **may** perform imports into more than a one list at a given time.

## 5. After importing

Now that you've begun your import, here's what you can expect:

1. Most imports average 5 to 15 minutes to process. For larger files, it may take up to 24 hrs for your data to process.
2. Once your import finishes, you will receive an **email notification** and an **in-product notification** under the **Notification icon** in the top right corner.
3. View your [import history](/s/article/Viewing-your-data-import-history) to see the results of your import where you can view or download:
   * Skipped Rows
   * Errors
   * Original CSV file
4. For any errors or skipped rows above, download the CSV to fix the issues and import those separately to complete your import.

<img src="https://mintcdn.com/support-affinity/gNHMiKP2aDiIOSeo/images/admin-data-migration/how-to-import-data-into-affinity/8.jpg?fit=max&auto=format&n=gNHMiKP2aDiIOSeo&q=85&s=1a26fd46dbd868901717fbe02763434a" alt="" width="2314" height="1510" data-path="images/admin-data-migration/how-to-import-data-into-affinity/8.jpg" />

5. If you need to **undo an import**, you can find out more in our [Undo Imports](/s/article/How-to-undo-imports-in-Affinity) article.
