> ## Documentation Index
> Fetch the complete documentation index at: https://docs.databar.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Enrichments
> Automatically populate your tables with data from third-party providers.
Enrichments let you add new columns to your table by pulling data from third-party providers. Hand Databar 500 email addresses and it can return full names, job titles, company sizes, and locations without you touching a single API.
## Use cases
Enrichments work for any scenario where you have partial data and need to fill in the gaps:
* **SEO and content**: find which emails clicked on your content
* **Sales intelligence**: get estimated revenue and employee counts for target accounts
* **Competitive research**: scrape pricing pages and product catalogs
* **Prospecting**: find decision-maker emails from company domains
* **Data hygiene**: verify email addresses before launching outreach
## How to add an enrichment
Make sure your table has the data you want to enrich and that your column names are clean and descriptive. For example, if you plan to look up emails by domain, you need a column containing domains.
Click **Enrich** in the top-left corner of your table.
Browse or search the enrichment catalog. Each card shows what the enrichment does, which parameters it expects, and how many credits it costs per row.
Link each enrichment parameter to a column in your table. Databar tries to auto-populate inputs by matching your column names to the enrichment's parameters, so in many cases the mapping is already done for you. Type `{` inside a parameter field to see a list of available columns. Required parameters must be mapped before you can proceed; optional parameters can be left blank.
The enrichment returns a set of output fields. Choose which ones you want added to your table. You can always add or remove response columns later. Click **Add x Columns** to attach the enrichment and its output columns to your table.
Hit **Run** to process your rows. You can run all rows, run only empty rows, or run a single row to test.
## Column mapping
Every enrichment defines a set of input parameters. When you attach an enrichment to a table, you map those parameters to your columns so Databar knows which data to send for each row.
* **Required parameters** must be mapped to a column or given a static value.
* **Optional parameters** can be left empty. The enrichment will still run, but the provider may return fewer results.
Type `{` in any parameter field to reference a column by name.
## Response columns
Each enrichment returns structured data: fields like `email`, `phone`, `company_name`, `employee_count`, and so on. During setup you choose which fields become columns in your table. Adding more columns later does not re-run existing rows; only new runs populate the additional columns.
## Cell-level statuses
After a run, every enriched cell shows exactly what happened:
* **Completed**: the provider returned data for this row.
* **Error**: something went wrong (invalid input, provider timeout, etc.).
* **No data**: the provider ran successfully but had no result for this input.
These statuses are tracked per cell, so you can run multiple enrichments in parallel and see independent results for each one.
## Column grouping
When an enrichment adds many columns, Databar groups them under a single collapsible header to keep your table readable. Click the double-arrow button on a grouped column to expand it into individual columns.
## Credit costs
The enrichment sidebar shows the per-row credit cost before you run. A pricing preview estimates the total based on how many rows will be processed, so there are no surprises.
For details on how credits work and how to manage your balance, see [Credits and billing](/product-guide/credits-and-billing).
## Run strategies
When you click **Run**, you can choose how rows are processed:
| Strategy | Behavior |
| ------------------ | ----------------------------------------------------------------------------------------- |
| **Run all rows** | Processes every row in the table, including rows that already have results. |
| **Run empty only** | Skips rows that already have data for this enrichment. Useful after adding new rows. |
| **Run single row** | Processes one row so you can verify the enrichment works before committing to a full run. |
## Controlling which rows run
Use [run conditions](/product-guide/run-conditions) to write expressions that decide whether a row should be enriched. Rows that don't match are skipped and don't consume credits.
## Automating enrichments
Instead of clicking Run manually each time, you can set enrichments to run on a schedule or whenever source data changes. See [Automations](/product-guide/automations) for setup instructions.
## Next steps
Write conditional expressions to control which rows get enriched.
Schedule enrichment runs or trigger them automatically on data changes.
Understand how enrichment costs are calculated and billed.
Browse and run enrichments programmatically via the REST API.