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

# CSV Data Processing

Figranium provides built-in support for parsing and utilizing CSV data, making it easy to drive automations with bulk datasets.

## **The CSV Action**

The `csv` action block parses CSV-formatted text into an array of objects.

* **Input**: Takes a raw CSV string in the `value` field. If empty, it uses `block.output` from the previous step.
* **Output**: The resulting array is stored in a variable of your choice (via `varName`).
* **Header Mapping**: Automatically uses the first row of the CSV as keys for the objects.

## **Common Use Cases**

* **Bulk Registration**: Drive a signup task with a CSV list of user details.
* **Automated Search**: Perform searches for a list of keywords or product SKUs.
* **Data Enrichment**: Update a local dataset by visiting URLs and extracting information.

## **Workflow Example**

1. **Extract Data**: Use a `javascript` block to read a CSV file's content or fetch it from a URL.
2. **Parse CSV**: Add a `csv` action, setting the `varName` to `bulkData`.
3. **Iterate**: Use a `foreach` action with the selector `bulkData` (or a variable reference).
4. **Execute**: Inside the loop, use `{$loop.item.column_name}` to access specific fields for each row.

## **Tips**

* **Quoting**: Ensure your CSV data uses standard quoting if fields contain commas or newlines.
* **Empty Rows**: Figranium automatically filters out empty rows to prevent execution errors.