Variables allow you to personalize your email content and subject lines for each subscriber.

## Syntax

Use double curly braces to insert variables:

```
{{variableName}}
```

### With Default Value

Add a fallback value when the variable is empty:

```
{{variableName | 'Default Value'}}
```

Or with double pipe:

```
{{variableName || 'Default Value'}}
```

## Examples

### Subject Line

```
{{name | 'Hey'}}, voici ton guide LinkedIn
```

**Result:**

- If subscriber has name "Marie" → `Marie, voici ton guide LinkedIn`
- If subscriber has no name → `Hey, voici ton guide LinkedIn`

### Email Content

```
Hello {{name | 'there'}},

Your email is {{email}}.
```

## Available Variables

### Built-in Variables

| Variable             | Description                                        |
| -------------------- | -------------------------------------------------- |
| `{{name}}`           | Subscriber's name                                  |
| `{{email}}`          | Subscriber's email address                         |
| `{{phone}}`          | Subscriber's phone number                          |
| `{{ipAddress}}`      | Subscriber's IP address (captured at signup)       |
| `{{country}}`        | Subscriber's country code (e.g., "US", "FR", "CH") |
| `{{unsubscribeUrl}}` | Unsubscribe link                                   |
| `{{onlineUrl}}`      | View in browser link                               |

### Organization Variables

| Variable          | Description           |
| ----------------- | --------------------- |
| `{{org-name}}`    | Organization name     |
| `{{org-adresse}}` | Organization address  |
| `{{org-logo}}`    | Organization logo URL |

### Custom Fields

Any custom field you create for subscribers can be used as a variable:

```
{{customFieldName | 'default'}}
```

## Using Variables in Editor

1. Type `@` in the editor to open the variable menu
2. Select or type your variable name
3. Click on the variable to edit the default value

## Tag Action Links

Tag action links use variable-like syntax only in a link's URL; they are not content or subject-line variables.

```
{{addTag:interested}}
{{removeTag:promo}}
```

For the editor flow, delivery restrictions, success page, and workflow use cases, see [Tag Action Links](/docs/features/tag-action-links).

## Best Practices

- Always provide default values for optional fields like `name`
- Use descriptive default values that make sense in context
- Test your emails with subscribers who have missing data

## Related Documentation

- [Tag Action Links](/docs/features/tag-action-links) - Let subscribers add or remove tags by clicking a link
- [Send Email API](/docs/api-reference/api-emails-send) - Use variables in transactional emails
- [Workflows](/docs/workflows) - Use variables in workflow email steps
- [Language](/docs/features/language) - Recipient-page language vs email footer copy
- [Content Deliverability](/docs/features/content-deliverability) - Required variables like `{{unsubscribeUrl}}`
- [Create Subscriber](/docs/api-reference/api-subscribers-post) - Add custom fields for personalization