# Highlight Occurrences

**Highlight Occurrences** visually marks all instances of the selected text or search term in the script, helping you quickly identify patterns, variables, or repeated code elements.

<figure><img src="/files/0u2JlyCbxTTHAZ8xVdcp" alt=""><figcaption></figcaption></figure>

***

### 🛠️ Setup

Before using the tool, configure its behavior in **Textify Preferences**:

* **Highlight Mode**:
  * **Auto**: If a search term is entered, it highlights all matches for that term. If not, it highlights matches of the current selection.
  * **Find Text**: Highlights only the matches of the active search term.
  * **Selection**: Highlights all occurrences of the selected text, regardless of search input.
* **Case Sensitive**: Match only text that shares the same capitalization as the selected or searched word.
* **Show in Scrollbar**: Toggles small indicators on the scrollbar, giving you a quick visual overview of all occurrences.
* **Color**: Choose a predefined highlight color theme, or select **Custom** to define your own:
  * **Background** color of the highlight
  * **Foreground (text)** color
  * **Scrollbar indicator** color

***

### ❓How to Use

To activate:

* Use the toggle found in the **Textify popover** in the Text Editor header.

> ⚠️ **Note:** The Highlight Occurrences toggle resets each time you restart Blender. You must manually enable it after reopening.

Once enabled, highlights will appear in your text editor based on the mode you selected in preferences.


---

# 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://jishnujithu.gitbook.io/textify/tools/highlight-occurrences.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.