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

# Generator Overrides

> Override auto-detected generators with a YAML file.

# Generator Overrides

Override auto-detected generators for specific columns using a YAML configuration file.

## Syntax

```yaml theme={null}
<table_name>:
  <column_name>:
    generator: <generator_name>
    params:
      <param_name>: <value>
    disabled: true|false
```

## Example

```yaml theme={null}
users:
  email:
    generator: email
  role:
    generator: weighted_choice
    params:
      choices:
        admin: 5
        user: 95
  created_at:
    generator: now
  internal_code:
    disabled: true

orders:
  total:
    generator: amount
    params:
      min: 10.00
      max: 9999.99
  status:
    generator: weighted_choice
    params:
      choices:
        pending: 30
        completed: 60
        cancelled: 10
```

## Usage

```bash theme={null}
seedling generate --count 10000 --generators overrides.yaml --output seed.sql
```

## Merging Behavior

Override generators are **merged** on top of auto-detected generators:

* If a column has an override, it replaces the auto-detected generator
* If a column has `disabled: true`, no data is generated (NULL or default)
* Columns not mentioned in the override file use auto-detected generators
* Unknown table or column names in overrides produce a warning

## Parameter Reference

| Generator         | Parameters                        |
| ----------------- | --------------------------------- |
| `email`           | —                                 |
| `name`            | —                                 |
| `phone`           | —                                 |
| `uuid`            | —                                 |
| `bool`            | —                                 |
| `lorem`           | `min_words`, `max_words`          |
| `constant`        | `value`                           |
| `weighted_choice` | `choices` (map of value → weight) |
| `random_int`      | `min`, `max`                      |
| `float_range`     | `min`, `max`, `precision`         |
| `amount`          | `min`, `max`                      |
| `timestamp`       | `min_date`, `max_date`            |
| `time_ago`        | `max_duration`                    |