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

# Text Selection

> Use Beat's text selection popup to sharpen, simplify, rewrite, or fix the tone of any text.

The text selection popup lets you refine specific text in your Brand Beat profile without opening the chat panel or manually editing a field from scratch. Highlight any text, choose an action, and Beat returns a targeted suggestion.

## What the text selection popup is

When you highlight text on any Brand Beat page — inside a field like your positioning statement, a content pillar description, or your voice descriptors — a small popup appears with four action buttons. Click one and Beat processes just that selection, returning a proposed change for you to accept or dismiss.

This is different from the chat panel: the text selection popup is fast and scoped to a specific piece of text. No conversation required.

## The four actions

| Action       | What it does                                                        | Best used for                                                       |
| ------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **Sharpen**  | Makes the language tighter and more specific, cuts filler words     | Positioning statements that feel vague or too long                  |
| **Simplify** | Clears out jargon and complexity, makes the meaning easier to grasp | Value propositions heavy with buzzwords                             |
| **Rewrite**  | Generates a fresh take on the same idea with different phrasing     | When the current version doesn't feel right but you're not sure why |
| **Fix tone** | Rewrites the selection to better match your voice descriptors       | Voice or tone text that sounds generic or off-brand                 |

## How to use it

<Steps>
  <Step title="Navigate to a Brand Beat tab">
    Go to `/app/brand` and open any tab — Identity & Voice, Pillars & Content, Audience, etc.
  </Step>

  <Step title="Select text in a field">
    Click and drag to highlight the text you want to refine. You can select a single sentence or an entire paragraph.
  </Step>

  <Step title="Click an action">
    The popup appears above your selection with the four action buttons. Click whichever action fits your goal.
  </Step>

  <Step title="Review the proposed change">
    Beat returns a proposed change card showing your original text and the suggested version side by side. Apply it or dismiss it.
  </Step>
</Steps>

## Where it works

The text selection popup is active on Brand Beat pages:

* Identity & Voice fields (positioning, tagline, value proposition, voice descriptors, tone guidelines)
* Pillars & Content fields (pillar names, descriptions, editorial guidelines)
* Audience fields (ICP description, pain points, goals)

It also works inside the article editor — but with a slightly different action set tuned for long-form writing: **Make punchier**, **Simplify**, **Expand**, and **Fix tone**.

## Use cases by field type

**Positioning statement** — Sharpen is most useful here. Positioning statements tend to get wordy. Sharpen cuts it down to what actually matters.

**Voice descriptors** — Try Fix tone if your descriptors feel generic ("professional," "approachable"). Beat will translate those into more specific, characteristic phrases.

**Value proposition** — Simplify works well if you've written something packed with industry terms. Beat will find the plain-English version without losing the meaning.

**Content pillar descriptions** — Rewrite helps when a pillar description is technically accurate but doesn't feel right. Sometimes you need Beat to take a fresh angle at the same idea.

<Tip>
  Use Sharpen on your positioning statement first. It's the most important field in Brand Beat, and it's the one that tends to be most over-written during the intake process.
</Tip>

## What happens after you click an action

Beat opens a proposed change card showing:

* The **original text** (left / top)
* Beat's **suggested revision** (right / bottom)

You can Apply the suggestion (it saves directly to the field) or Dismiss it (keeps the original). See [Proposed Changes](/beat/proposed-changes) for full details.

## What's next?

<CardGroup cols={2}>
  <Card title="Proposed Changes" icon="arrows-left-right" href="/beat/proposed-changes">
    How to apply, dismiss, and work with Beat's suggested edits.
  </Card>

  <Card title="Identity & Voice" icon="pen-nib" href="/brand/identity-voice">
    The fields where text selection has the biggest impact.
  </Card>
</CardGroup>