# Find & Replace

Supervertaler's Find & Replace feature helps you quickly find text and make consistent changes across your translation.

### Opening Find & Replace

* Press `Ctrl+F` or `Ctrl+H`
* Or go to **Edit → Find & Replace**

### Dialog layout

The action buttons are grouped to make destructive actions visually distinct from non-destructive ones. Reading left to right:

* **Find next | Find all | Highlight all | Clear highlights** – non-destructive: searching and highlighting only, no edits made.
* A vertical separator marks the boundary.
* **Replace this | Replace all** – destructive: these modify your translation. They appear with an **amber background** as a visual cue that clicking them changes the document.

The Close button sits at the far right.

#### Keyboard shortcuts inside the dialog

| Key        | Where                | Action                                                                          |
| ---------- | -------------------- | ------------------------------------------------------------------------------- |
| **Enter**  | in the Find field    | Triggers **Find next**                                                          |
| **Enter**  | in the Replace field | Triggers **Replace all** (the existing confirmation prompt still appears first) |
| **Escape** | anywhere             | Closes the dialog                                                               |

The Enter-in-Replace shortcut is intentional: the Replace all confirmation dialog catches accidental presses, so pressing Enter never silently overwrites your translation.

### Basic Usage

#### Finding Text

1. Type your search term in the **Find** field
2. Click **Find all** to see all matches, or press **Enter** for Find next
3. Matches are highlighted in yellow in the grid
4. The results counter shows how many matches were found

#### Replacing Text

1. Type your search term in the **Find** field
2. Type your replacement in the **Replace** field
3. Click the amber **Replace all** button, or press **Enter** while the Replace field has focus
4. Confirm the replacement count when the dialog asks
5. A confirmation shows how many replacements were made

### Search Options

#### Match Mode

| Mode            | Description                      |
| --------------- | -------------------------------- |
| **Contains**    | Matches anywhere in the text     |
| **Whole Word**  | Only matches complete words      |
| **Starts With** | Matches at the beginning of text |
| **Ends With**   | Matches at the end of text       |
| **Regex**       | Use regular expressions          |

#### Case Sensitivity

Toggle **Case Sensitive** to:

* ✅ **On**: "Hello" won't match "hello"
* ❌ **Off**: "Hello" matches "hello", "HELLO", etc.

#### Search Scope

| Scope               | Description                 |
| ------------------- | --------------------------- |
| **Source + Target** | Search in both columns      |
| **Source Only**     | Search only in source text  |
| **Target Only**     | Search only in translations |

### History Dropdowns

Both the Find and Replace fields remember your recent searches:

* Click the dropdown arrow to see your last 20 entries
* Start typing to filter the history
* History persists between sessions

### F\&R Sets (Batch Operations)

Save and reuse multiple find/replace operations as a set.

#### Creating a Set

1. Expand the **📁 F\&R Sets** panel
2. Click **➕ New Set**
3. Give your set a name (e.g., "Client Style Guide")
4. The set appears in the dropdown

#### Adding Operations to a Set

1. Enter your Find and Replace terms
2. Set your options (case, scope, mode)
3. Click **➕ Add Current to Set**
4. The operation is saved to the active set

#### Managing Operations

In the F\&R Sets panel:

* ✅ Enable/disable individual operations
* 📝 Edit operations (double-click)
* ⬆️⬇️ Reorder operations
* 🗑️ Delete operations

#### Running a Batch

1. Select your set from the dropdown
2. Click **▶️ Run All**
3. A progress dialog shows each operation
4. See how many replacements were made

#### Importing & Exporting Sets

Share sets with colleagues:

* **Export**: Click **📤 Export Set** to save as `.svfr` file
* **Import**: Click **📥 Import Set** to load a shared file

### Use Cases

#### Terminology Consistency

Create a set for client-specific terms:

* "colour" → "color" (US spelling)
* "organisation" → "organization"
* "programme" → "program"

#### Style Guide Rules

Enforce style guidelines:

* Double spaces → Single space
* "e.g." → "for example"
* Straight quotes → Curly quotes

#### Post-Translation Cleanup

Clean up common MT artifacts:

* Remove unwanted spaces before punctuation
* Fix capitalization issues
* Normalize formatting

### Tips

:::tip **Pro Tip:** Use regex mode for complex patterns. For example, `\s+` matches any whitespace to clean up extra spaces. :::

:::note **Undo Support:** All replacements can be undone with `Ctrl+Z` (within the same session). :::


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://supervertaler.gitbook.io/help/editor-and-translation/find-replace.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.