# Reconciliation Configuration

Configure reconciliation strategy, progress updates, and retries in Blnk.

This page covers the settings that control how Blnk runs reconciliation jobs and reports progress.

## Reconciliation settings

Use these settings to configure the default reconciliation strategy, progress updates, and retry behavior.

<Note>
In `blnk.json`, `retry_delay` is integer seconds. The environment variable accepts Go duration format (e.g. `5s`).
</Note>

<CodeGroup>
```bash blnk.env
BLNK_RECONCILIATION_DEFAULT_STRATEGY=one_to_one
BLNK_RECONCILIATION_PROGRESS_INTERVAL=100
BLNK_RECONCILIATION_MAX_RETRIES=3
BLNK_RECONCILIATION_RETRY_DELAY=5s
```

```json blnk.json
{
  "reconciliation": {
    "default_strategy": "one_to_one",
    "progress_interval": 100,
    "max_retries": 3,
    "retry_delay": 5
  }
}
```
</CodeGroup>

<ParamField name="BLNK_RECONCILIATION_DEFAULT_STRATEGY" default="one_to_one">
Default matching strategy used for reconciliation.
</ParamField>
<ParamField name="BLNK_RECONCILIATION_PROGRESS_INTERVAL" default="100">
Number of records Blnk processes before it emits a progress update.
</ParamField>
<ParamField name="BLNK_RECONCILIATION_MAX_RETRIES" default="3">
Maximum number of retry attempts for failed reconciliation work.
</ParamField>
<ParamField name="BLNK_RECONCILIATION_RETRY_DELAY" default="5s">
Time Blnk waits before retrying failed reconciliation work.
</ParamField>

### `BLNK_RECONCILIATION_DEFAULT_STRATEGY`

This sets the reconciliation strategy Blnk uses by default.

Use `one_to_one` when one ledger record should match one external record. Change it only when your reconciliation flow regularly needs one-to-many or many-to-one matching.

### `BLNK_RECONCILIATION_PROGRESS_INTERVAL`

This controls how often Blnk reports progress while a reconciliation job is running.

<Tip>
**Tip:** Use a smaller value when you want more frequent progress updates. Use a larger value when you want fewer progress events during large jobs.
</Tip>

<RelatedTopics
  items={[
    { title: "Reconciliation overview", href: "/reconciliations/overview" },
    { title: "Data stores", href: "/operating/configuration/data-stores" },
    { title: "Matching rules", href: "/reconciliations/matching-rules" },
    { title: "Reconciliation strategies", href: "/reconciliations/strategies" },
  ]}
/>