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

# Supplier Imports

> Create or update suppliers from a CSV file, including contact details and custom attributes.

## Overview

The Suppliers importer bulk-creates or updates suppliers from a single CSV. Matching is **case-insensitive on `name`** — rows whose name matches an existing supplier update that supplier, and rows with a new name create one.

## Columns

| Column         | Required | Description                                                               |
| -------------- | -------- | ------------------------------------------------------------------------- |
| `name`         | Yes      | The supplier name. Matched case-insensitively against existing suppliers. |
| `description`  | No       | Free-text description.                                                    |
| `phone_number` | No       | Contact phone number.                                                     |
| `address`      | No       | Supplier address.                                                         |
| `email`        | No       | Contact email address.                                                    |
| `contact_name` | No       | Name of the primary contact.                                              |

<Warning>
  Each supplier name may appear only once per file. Two rows with the same name (compared case-insensitively) produce a duplicate-name validation error.
</Warning>

## Custom attributes

Any column not in the standard list above is treated as a custom attribute on the supplier. Custom attribute columns must match a configured attribute key for your organization; unknown columns cause a validation error.

## Related pages

For general import behavior, empty cell handling, and error reporting, see [Importers](/administration/ion-importers).