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

# Bulk Enrich

> Enrich a list of leads or customers with contact and profile data from Minerva

Bulk Enrich adds contact and profile data to a list of your leads or customers. Upload a spreadsheet, and Minerva matches your rows to people in its data and creates a segment of the people it finds.

## Before you start

* **Use a CSV or Excel file.** Excel files can be `.xls` or `.xlsx`.
* **Give each row enough to match on.** A LinkedIn URL matches on its own. Without one, combine a name with an email, a phone number or an address.
  * A name is a full name, or a first and last name.
  * An address is a street with a ZIP, a street with a city and state, or a single full-address column.

Your file has to stay within all of these limits:

| Limit | Maximum |
| - | - |
| Rows | 100,000 |
| Columns | 250 |
| Total cells (rows × columns) | 5,000,000 |
| CSV file size | 300 MB |
| Excel file size | 25 MB |
| Sheets in a workbook | 50 (one sheet is processed per upload) |

## Upload and enrich a list

**1. Open Bulk Enrich**

In the sidebar, go to [**Segments → Bulk Enrich**](https://app.minerva.io/bulk-enrich) and start an upload. **How Bulk Enrich works** opens a short guide.

**2. Add your file**

Add a CSV or Excel file. If a workbook has more than one sheet with data, choose the **Sheet** to use.

**3. Map your columns**

Minerva suggests a mapping. Assign a Minerva field to each column you want to use and skip the rest. The fields are:

* Name: **Full name**, **First name**, **Last name**
* Contact: **Email**, **Phone**, **LinkedIn URL**
* Address: **Full address**, **Street**, **Unit / apt**, **City**, **State**, **ZIP**

**4. Start the enrichment**

Check the count of rows that have the required fields, then select **Start enrichment**. That count shows how many rows Minerva can try to match, not how many will match. The app lets you know when it finishes.

**5. Open the results**

Select **View results**. The results open as a segment, with an **Enrichment summary** alongside the usual **Insights** and **People** views.

> [!NOTE]
>
> Columns you skip aren't used for matching. Mapping a column doesn't fill in rows where that column is empty.

## Read the results

**Records matched** is the number of people in the segment. The **Enrichment summary** shows **Matched rows** (the number matched out of the number uploaded) and the **Match rate**.

* **The segment holds only matched people.** Unmatched rows aren't added to it.
* **A repeated person is counted once.** If the same person is on several rows, Minerva combines those rows before it counts. The total in **Matched rows** can then be lower than the number of rows in your file.
* **Not every match has every contact type.** Check **Contact properties** to see how many matched people have an email, a phone number, an address or a LinkedIn profile.
* **Match rate is your Minerva match rate.** It's the share of your rows Minerva linked to a person. It doesn't tell you your platform match rate, which is how many of those people an ad platform will match.
* **You can see why a match rate is low.** When the result shows **Low match rate**, select **Explain**.

## Improve your match rate

* Add more identifiers per row. A name with an email, a phone number and an address matches more reliably than a name with one of them.
* Include LinkedIn URLs where you have them.
* Remove columns you don't need so the file stays inside the limits.

## Limits and billing

Enriching a list inside Minerva doesn't use your record export allowance. Activating the segment later can, depending on the destination.

Creating the segment doesn't send anything to an ad platform, a CRM or any other destination. Activate it when you're ready.

## Troubleshooting

| Problem | What to do |
| - | - |
| The enrichment fails | The app shows **Enrichment failed. Try uploading the file again.** Upload the file again. If it keeps failing, check the file against the limits above. |
| A column shows a mapping warning | The column is mapped in a way that can't be used. Fix or skip the column before you start. |
| Fewer rows are ready than you uploaded | Only rows with enough identifiers to match on count as ready. Add identifiers to the other rows and upload again. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.