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

# Spintax

> Vary words and phrases in your template so your proposals do not all read the same.

Spintax gives one spot in your text several phrasings. For each proposal, Vollna picks one of them at random. It works in the letter of [Template structure](https://www.vollna.com/docs/bidding/template-structure.md) and in [Targeted Answers](https://www.vollna.com/docs/bidding/ai-writer.md#targeted-answers).

**Add Spintax** in the editor toolbar opens the **Spintax** dialog. Each spintax holds two to five variations. In the editor's code view, a spintax reads like this:

```
{{SPINTAX:Hello|Hi|Greetings}}
```

Each proposal gets one of "Hello", "Hi" or "Greetings". Vollna picks the variation before the AI writes, so the AI prompts around it fit the words it got.

## Examples

Vary the lines that stay the same in every letter: the greeting, a proof line, the sign-off. Let AI prompts write the parts about the job.

### Proof line

```
{{SPINTAX:Last year I built|I recently built|I built}} a Stripe checkout for a subscription app.
```

Possible results:

* "Last year I built a Stripe checkout for a subscription app."
* "I recently built a Stripe checkout for a subscription app."
* "I built a Stripe checkout for a subscription app."

### Sign-off

```
{{SPINTAX:I can start this week.|I'm free to start this week.|I have time for this from this week.}}
```

## Combine spintax with AI prompts

```
{{SPINTAX:Hi|Hello}},

{{AI:One sentence on the client's main problem, taken from the job post}}

{{AI:One past project that matches this job, with its result}}

{{SPINTAX:I can start this week.|I'm free to start this week.}}

Jane
```

## Write good variations

Read every combination out loud before you save. Each one goes to a client.

Keep the meaning and the tone the same in every variation:

```
✅ {{SPINTAX:experienced|skilled|proficient}}
❌ {{SPINTAX:experienced|okay|super amazing}}
```

Make every variation fit the sentence around it:

```
✅ I have {{SPINTAX:5 years of|extensive|significant}} experience.
❌ I have {{SPINTAX:5 years|a lot|experienced}} experience.
```

Vary whole phrases. Many small spintax groups produce awkward sentences:

```
✅ {{SPINTAX:I can start this week|I'm free to start this week}}
❌ {{SPINTAX:I|We}} {{SPINTAX:can|could}} {{SPINTAX:start|begin}} {{SPINTAX:soon|now}}
```

A variation can't contain the `}` character.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.