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

# Personalization

> Use variables, spintax, and conditional logic to personalize emails.

ColdSend supports multiple personalization methods to make each email feel tailored to the recipient.

## Variables

Use double curly braces to insert dynamic values:

```text theme={null}
Hi {{first_name}},

I noticed {{company}} is expanding. I'd love to share how we've helped companies like {{company}}.

Best,
John
```

### Standard Variables

| Variable         | Description          |
| ---------------- | -------------------- |
| `{{first_name}}` | Lead's first name    |
| `{{last_name}}`  | Lead's last name     |
| `{{email}}`      | Lead's email address |
| `{{company}}`    | Lead's company name  |
| `{{job_title}}`  | Lead's job title     |

### Custom Variables

Any custom field from your CSV is available:

```text theme={null}
I noticed you're looking to fill {{custom_open_positions}} roles this quarter.
```

Custom fields in your CSV are mapped during upload and are available as `{{custom_field_name}}`.

### Dynamic Variables

ColdSend provides computed variables:

| Variable                             | Output                                                                      |
| ------------------------------------ | --------------------------------------------------------------------------- |
| `{{dn_time_of_day}}`                 | Good morning/afternoon/evening based on send time                           |
| `{{dn_day_of_week}}`                 | Day name (e.g., Monday)                                                     |
| `{{dn_day_name}}`                    | Same as `dn_day_of_week`                                                    |
| `{{dn_date N days from now format}}` | Formatted future date. Example: `{{dn_date 2 days from now dddd, MMMM Do}}` |

## Spintax

Randomly select one option from a list:

```text theme={null}
{{Hi|Hello|Hey}} {{first_name}},
```

Each email randomly uses one greeting: Hi John, Hello John, or Hey John.

**Rules:**

* Minimum 2 options
* Separated by `|`
* Wrapped in `{{` and `}}`
* Can be nested with variables: `{{I noticed|I saw that}} {{company}} recently {{launched a product|expanded|hired}}`

## Conditional Logic

Use Liquid-style conditionals for dynamic content:

### Basic If/Else

```text theme={null}
{{#if first_name}}
Hi {{first_name}},
{{else}}
Hi there,
{{/if}}
```

### Value Comparison

```text theme={null}
{{#if industry == Technology}}
I work with tech companies like yours...
{{else if industry == Finance}}
Helping financial services firms...
{{else}}
We help businesses across industries...
{{/if}}
```

### Logical Operators

```text theme={null}
{{#if industry == Technology and company_size > 50}}
For growing tech teams...
{{/if}}

{{#if industry == Technology or industry == Software}}
For tech innovators...
{{/if}}
```

### Contains Operator

```text theme={null}
{{#if job_title contains Manager}}
As a manager, you might be interested in...
{{/if}}
```

### Unless

```text theme={null}
{{#unless unsubscribed}}
Hope to hear from you soon!
{{/unless}}
```

### Empty Check

```text theme={null}
{{#if first_name empty}}
Hi there,
{{else}}
Hi {{first_name}},
{{/if}}
```

## Fallback Values

Handle missing data with pipe syntax:

```text theme={null}
Hi {{first_name|there}},
```

Uses there if `first_name` is empty or missing.

## Combining Features

```text theme={null}
{{Hi|Hello}} {{first_name}},

{{#if company}}
I noticed {{company}} is in the {{industry}} space.
{{else}}
I wanted to reach out with something that might help your business.
{{/if}}

Best,
John
```

## Best Practices

1. **Keep it natural** — Personalize 1-2 key details, not every field
2. **Handle missing data** — Always provide fallbacks for optional fields
3. **Use spintax for variety** — Add variety without creating multiple variants
4. **Test different approaches** — Use variants to test personalization strategies

## Next Steps

<CardGroup cols={2}>
  <Card title="Email Variants" href="/campaigns/variants" icon="files">
    A/B testing and variant configuration.
  </Card>

  <Card title="Follow-up Sequences" href="/campaigns/sequences" icon="layers">
    Automated follow-up sequences.
  </Card>
</CardGroup>