> For the complete documentation index, see [llms.txt](https://jishnujithu.gitbook.io/textify/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jishnujithu.gitbook.io/textify/tools/highlight-occurrences.md).

# 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="https://1369578556-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDnkuhGf8ejPBS5cgVCH0%2Fuploads%2F1UKEh1sVW8xjW7xaFLdX%2Fhighlight-occurrences.gif?alt=media&amp;token=81a7279e-dd30-40b4-8f53-892ba49999c0" 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.