> ## Documentation Index
> Fetch the complete documentation index at: https://magic-post.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Saved captions and brand voice

> Keep reusable captions and hashtag groups, and describe your tone once so the AI writing assistant follows it.

Two library pages save you from retyping. **Captions** stores text and hashtag sets you reuse. **Brand voices** teaches the AI writing assistant how your accounts sound. Both are under **Library** in the sidebar.

## Captions

Open **Library → Captions**. The page reads **Keep the lines and hashtag groups you reuse, then drop them into any post.** It holds two kinds of items:

| Kind | What it is |
| - | - |
| **Caption** | A line, opener, sign-off or call to action. |
| **Hashtag group** | A set of hashtags that you add to a caption in one click. |

Switch between the two with the **Captions** and **Hashtag groups** tabs at the top.

### Create an item

**1. Start a new item**

Select **New caption**, or **New hashtag group** when that tab is open.

**2. Name it**

Fill in **Name**, for example `Weekly tip opener` or `Product launch tags`. The name is required and can be up to 160 characters. It is how you recognise the item in lists.

**3. Add the text**

For a caption, write the text under **Text** (up to 5,000 characters). For a hashtag group, type hashtags under **Hashtags**, separated by spaces or commas. The hash is added for you and repeats are dropped. The group is stored as a clean single-spaced list, such as `#launch #evergreen`.

**4. Add labels (optional)**

**Labels** are comma-separated words, for example `launch, evergreen`. They are only used to find things later.

**5. Save**

Select **Save**. The message **Saved to your library.** confirms it.

The editor lets you change the kind with **Caption** and **Hashtag group** at the top.

### Find and manage items

* **Search your library** matches the name and the text.
* Sort by **Name**, **Most used** or **Newest**. **Most used** counts how often you inserted an item in the composer.
* Each item has **Edit**, **Duplicate** (the copy is called `Title (copy)`), **Delete** and **Copy**. Copying puts the text on your clipboard and shows **Copied**.
* A hashtag group shows its first hashtags and **+N more**.
* Deleting asks **Delete this?** and keeps any post that already uses the text unchanged.
* The list shows 12 items per page.

### Use them in the composer

In the composer, the caption toolbar has a **Saved** panel with **Captions** and **Hashtags** tabs and **Search saved**.

* A saved caption is **Inserted at the cursor**.
* A hashtag group is **Added to the end of the caption**.
* If you have nothing saved yet, the panel offers **Save your first caption** or **Save your first hashtag group**, and **Manage library** opens this page.

Anything saved here shows up in the composer under **Saved**. See [Composer](https://magic-post.mintlify.site/user-guide/composer.md).

You can also save from the AI assistant. Next to an option, **Save** keeps it in your library without adding it to the post. See [AI writing and media](https://magic-post.mintlify.site/user-guide/ai-tools.md).

## Brand voices

A brand voice describes how an account sounds, so every caption the assistant drafts follows it. Open **Library → Brand voices**.

> [!NOTE]
>
> Brand voices need the **AI writing** feature. When your plan does not include it, **Brand voices** shows a lock in the sidebar and leads to the upgrade page. On the page itself, creating or editing a voice is refused with a message that it needs AI writing, while voices you already have stay listed and can be deleted. When billing is not turned on for the site, the feature is available to everyone. See [AI writing and media](https://magic-post.mintlify.site/user-guide/ai-tools.md).

### Create a voice

Select **New voice**. Only the **Name** is required. The more you add, the closer the writing sounds like you.

| Field | What to write | Limit |
| - | - | - |
| **Name** | A short label, for example `Acme, warm and plain-spoken`. | 80 characters |
| **Language** | The language to write in, or **Whatever I pick each time**. | 28 languages |
| **How it sounds** | The tone, for example `Warm, confident, never salesy. Short sentences.` | 160 characters |
| **Who it speaks to** | The audience, for example `Small studio owners who post between client work`. | 255 characters |
| **Rules it keeps** | Style rules, for example `Say "we", not "I". No exclamation marks.` | 2,000 characters |
| **Posts that sound right** | Up to three **Example post** fields. They shape the style only, and their content is never reused. | 1,000 characters each |
| **Hashtags it prefers** | Used when you ask the assistant for hashtags. Separate them with spaces or commas. | 255 characters |

Tick **Pick this voice for me in the writing assistant** to make it your default, then select **Save voice**. Your first voice is made the default for you. A new default replaces the old one.

You can keep up to 20 voices. The page shows **N of 20 voices**, and at the limit you must delete one before adding another.

### Manage voices

Each voice card shows its tone, who it **Speaks to**, its **Rules**, and a **Default** tag on the default voice. The card menu (**Voice actions**) has **Edit**, **Make default** and **Delete**. Deleting asks **Delete this voice?** and leaves captions already written with it untouched.

### How the composer uses a voice

Open **Write with AI** in the composer. The **Voice** menu lists your voices and **No voice**.

* Your default voice is preselected each time you open the composer.
* If the voice has a language, the **Language** field takes it.
* The tone, audience, rules, example posts and preferred hashtags are sent to the model with the brief, so results follow your voice. Where the voice conflicts with the **Tone** you pick in the assistant, the voice wins. Preferred hashtags are used when hashtags are wanted.
* Pick **No voice** for a run that should not use one.
* **Set one up** or **Manage** opens this page when you have none.

Using a voice does not change what a run costs. See [AI writing and media](https://magic-post.mintlify.site/user-guide/ai-tools.md).


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