Setup

1. Install

1. Open Jira → Apps → Explore more apps.
2. Find Textreplacer for Jira and click Get it now (or use the direct install link from the Marketplace listing).
3. Confirm the requested permissions:
   • read:jira-work — to search issues by JQL and read their content.
   • write:jira-work — to update Summary/Description on Apply.
   • storage:app — to store operation history and rollback data.

No further configuration is required — the app has no admin settings page and no external accounts to connect.

2. Open the app

Go to Jira → Apps → Bulk Text Replacer. The app appears as a global page, accessible from any project.

Usage

Step 1 — Select issues with JQL

Enter a JQL query in the JQL field to target the issues you want to edit, e.g.:

project = ABC AND text ~ "old-product-name"

Cascade to children

Optionally enable Cascade by hierarchy to automatically expand the matched issues to include all their descendants:

• Off (default) — only update issues that directly match the JQL query.
• On — update matched issues AND all of their children recursively: Epic → Story → Task → Sub-task.

Important: Cascade works correctly in team-managed (next-gen) projects. In company-managed (classic) projects, Epic → Story links are managed by the "Epic Link" field rather than the parent field, so cascade will not find children of Epics. The UI will warn you if this limitation applies to your query.

Step 2 — Configure the replace

Basic fields