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

# Feedback Sources

> Sources that bring feedback data into a Feedback Directory.

A **Source** defines how external data is mapped into Feedback Records inside a Feedback Directory. Manage them from **Unify → Sources**.

## Source types

Formbricks supports three source types:

### 1. Formbricks Surveys

Pipe responses from a Formbricks survey directly into a Feedback Directory. Pick a survey, select the questions you want to ingest - that's it. Formbricks automatically maps each question to its `field_type`. Optionally create Feedback Records of existing responses on connect.

### 2. CSV Import

Upload a CSV (up to **2 MB** and **1,000 rows**) and Formbricks auto-suggests a column mapping based on common header names (`timestamp`, `response_id`, `rating`, `feedback_text`, ...). Required columns: `submission_id`, `field_id`, `field_type`, and the feedback value.

<Note>
  Re-uploading a CSV with the same `submission_id` updates existing records instead of creating duplicates.
</Note>

A sample CSV is available from the source creation dialog.

### 3. API Ingestion

Push records into a directory programmatically from your own systems. Best for server-to-server ingestion. API reference docs are coming soon.

## Field mapping

For CSV and API sources, you map each source column or question to a Feedback Record field. CSV mapping suggests matches automatically with high/medium/low confidence based on header names.

For Formbricks Surveys, we handle the mapping internally - each question type is translated into the matching Hub `field_type`:

* Single-select, multi-select, dropdown → `categorical`
* NPS → `nps`
* Rating → `rating`
* CSAT → `csat`
* CES → `ces`
* Free text → `text`
* Number → `number`
* Date → `date`
* Boolean / consent → `boolean`

## Managing sources

From the Sources page you can:

* **Create** a new source for any source type.
* **Edit** the mapping for an existing source.
* **Pause** or **resume** ingestion.
* **Delete** a source. Existing records stay in the directory.