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

# items_from_csv

> Build one dataset item per CSV row, with `items_from_pandas()`'s column mapping.

**New in version 0.8.0**

## Parameters

**file\_path** `str | Path` *required*

Path to the CSV file; its first row names the columns.

**input\_columns** `list[str] | None` (default: None)

Columns to use as inputs. If None, every column not
mapped elsewhere becomes an input.

**expected\_output\_columns** `list[str] | None` (default: None)

Columns holding the expected outputs.

**metadata\_columns** `list[str] | None` (default: None)

Columns to store as metadata.

**extras\_columns** `list[str] | None` (default: None)

Columns to store as extras.

**id\_column** `str` (default: "id")

Column holding each item's id. Defaults to "id".

**source\_name\_column** `str` (default: "source\_name")

Column holding the source name. Defaults to "source\_name".

**source\_id\_column** `str` (default: "source\_id")

Column holding the source id. Defaults to "source\_id".

## Returns

One item per row, in row order.

## Raises

* **ValueError** – If the file has no rows or a named column is missing.
* **ImportError** – If pandas is not installed.

## Example

```python theme={null}
items = items_from_csv("tests.csv", input_columns=["question"])
dataset = dataset.update_items(items=items).dataset
```