# Arguments

Prompt for input when a snippet expands.

`{argument}` pauses expansion and prompts you to type a value. Use it when a snippet needs information that changes each time you use it.

```
Hi {argument},

Just following up on our conversation.
```

When this expands, Nibit shows an input field. Type your value and confirm to complete the expansion.

## Named arguments

Give arguments a `name` to make the prompt clearer:

```
Hi {argument name="recipient"},

Following up on {argument name="topic"}.
```

Each unique name is a separate prompt. If the same name appears multiple times in a snippet, the value entered once is reused everywhere.

## Default values

Use `default` to pre-fill the input. If you confirm without changing it, the default is used:

```
{argument name="greeting" default="Hi"}
```

Arguments with a default are optional — skipping them uses the default. Arguments without a default are required.

## Predefined options

Use `options` to present a picker instead of a free-text field. Values are comma-separated:

```
{argument name="priority" options="Low, Medium, High"}
{argument name="tone" options="formal, casual, friendly"}
```

The user selects from the list rather than typing freely.

## Combining attributes

All attributes can be used together:

```
{argument name="tone" default="casual" options="formal, casual, friendly"}
```

## Limits

A snippet or quick link can contain at most **3 arguments**.
