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

# Snippets

> Short, reusable pieces of text you insert into any editor by typing a ;shortcut.

## Overview

Snippets are short, reusable pieces of text: a greeting, a signature, a stock
answer. That you drop into any editor by typing a `;shortcut`. They expand
inline as you type in the email composer and the document editor, so you never
retype the same paragraph twice. Unlike full [Templates](/comms/templates/overview)
(whole message bodies with AI personalisation), a snippet is a small fragment
you insert mid-writing. Manage them under **Settings → Conversations →
Snippets**.

## How it works

Every snippet has a **title**, an optional **shortcut**, an optional
**category** for organisation, and rich-text **content**. The content can
contain `{{variable}}` chips, placeholders shown as highlighted badges that
you fill in when the snippet is inserted.

### Scopes

Snippets live at one of three scopes, shown as tabs on the Snippets screen:

| Scope        | Who can use it            | Who can create it |
| ------------ | ------------------------- | ----------------- |
| **Company**  | Everyone in the workspace | Admins only       |
| **Team**     | Members of your groups    | Team members      |
| **Personal** | Only you                  | You               |

### Inserting a snippet

Give a snippet a **shortcut** (for example `intro`) and then, in the email
composer or document editor, type `;intro`. Custral replaces it with the
snippet's content. Snippets without a shortcut can still be managed here but
have no `;` trigger to insert them.

## Using it

<Steps>
  <Step title="Open Snippets">
    Go to **Settings → Conversations → Snippets** and choose the **Company**, **Team**, or **Personal** tab depending on
    who should see it.
  </Step>

  <Step title="Create the snippet">
    Click **New snippet**, give it a title and a short **shortcut**, then write the content. Add `{{variable}}` chips
    anywhere a value should be filled in.
  </Step>

  <Step title="Insert it while writing">
    In the email composer or document editor, type `;` followed by the shortcut (e.g. `;intro`) to expand the snippet in
    place.
  </Step>
</Steps>

## Troubleshooting

| Symptom                                          | Likely cause                                         | What to check                                                                                    |
| ------------------------------------------------ | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Typing `;shortcut` doesn't expand                | The snippet has no shortcut, or the shortcut differs | Open the snippet and confirm its **Shortcut** field matches exactly what you type after the `;`. |
| A teammate can't see a snippet                   | It's scoped **Personal** or to a different team      | Recreate it under the **Company** or **Team** tab so the right people can use it.                |
| Can't create a **Company** snippet               | Company snippets are admin-only                      | Ask a workspace admin, or create it under **Team** / **Personal** instead.                       |
| A `{{variable}}` shows literally after inserting | The placeholder wasn't filled in                     | Variables are prompts to complete on insert, replace the chip with the intended value.           |

<Note>
  When reporting an issue, include the request id shown in the error toast. It links the in-app error to the server
  logs.
</Note>

## Related

* [Templates](/comms/templates/overview): full, reusable message bodies with
  personalisation tokens and optional AI (as opposed to short inline snippets).
* [Composer Commands](/comms/email/commands): the `/` palette in the email
  composer, which lists your snippets alongside meeting times, forms and files.
* [Email compose](/comms/email/compose): one of the editors where `;shortcut`
  expansion works.


## Related topics

- [Install the widget](/comms/chat/widget-install.md)
- [Compose & Send](/comms/email/compose.md)
- [Smart Compose](/comms/email/smart-compose.md)
- [Templates](/comms/email/templates.md)
- [Composer Commands](/comms/email/commands.md)