ChatGPT is wrong. Learn how to find and replace on a single page, across multiple pages, even across spaces, in seconds without technical knowledge.
How anyone can find and replace in Confluence
download Space Content Manager (free trial) or read more about app
open it under apps (left hand side menu)
pick one or more spaces
choose pages
enter what want to find and replace
preview
click Replace
An example from our Confluence instance:
A video with full details (1:35)
Page level Confluence find and replace
On any page select ‘More actions’ to open the pull down menu. Then scroll down and select ‘Apps’ then ‘Content Manager’. Learn more.
What you can do with the Confluence find and replace features in Space Content Manager
find text
replace text
delete text
convert to UPPER or lower case
Space administrators can also
replace part or all of a URL
Use case: managing documentation
This 90 seconds video shows you how the apps works using the example of a person needing a Confluence find and replace to update documentation.
The find and replace feature is also a stand alone app on the Atlassian Marketplace called Find and Replace by Easy Apps.
Confluence find and replace with Space Content Manager supports:
most special characters like &, %, $, #
languages not using the Latin alphabet
Japanese, Chinese, Arabic, Greek, Hindi and more
See documentation for more details on how the app works.
Find and replace in Confluence: ScriptRunner versus Space Content Manager
How much is your time worth?
You could use ScriptRunner, but writing scripts for Confluence find and replace takes time, technical knowledge and often collaboration. Avoid scripting with ScriptRunner for bulk Confluence find and replace to save time and empower your team by using Space Content Manager (free trial).
ScriptRunner suggests:
”You could adjust this script to fit a wide variety of use cases, such as finding and replacing text on every page in a particular space, or any page that meets some other criteria.”
But only some organizations even have an administrator with CQL (Confluence Query Language) knowledge, some at best know JQL (Jira Query Language). Plus it lowers productivity as often have two people trying to solve a problem one could do with an app (one to explain, another to implement).
As a result updates do not happen often enough because they become too complex, require too much coordination. Plus each request for a Confluence search and replace could require updating the script or at least checking to make sure it is still working properly. Find and replace Confluence with an app is faster and something all users can do.
For the full guide to find and replace in Confluence, see Find and Replace for Confluence.
ChatGPT is wrong
According to ChatGPT no app exists to conduct Confluence find and replace.
Below is the what ChatGPT gives for the query ‘How to bulk find and replace in Confluence cloud?’:
Confluence Cloud (by Atlassian) doesn’t currently support native bulk find and replace across multiple pages. However, you can achieve this using one of the following methods:
Option 1: Use a Marketplace App
There are third-party apps available in the Atlassian Marketplace that support bulk find and replace:
Popular Options:
ScriptRunner for Confluence
Allows bulk content changes using scripts or macros.
Supports Groovy scripting for advanced search/replace.
Confiforms
Useful if your content is structured in forms/tables.
Content Formatting Macros (limited find/replace abilities but useful if pre-planned with macros)
Steps with ScriptRunner:
Install ScriptRunner from the Marketplace.
Use the Built-in Script: Search & Replace Content
Define your:
Space
Find (string or regex)
Replace string
Preview changes before applying
Option 2: Export → Edit → Import (for Advanced Users)
This is a workaround if you don’t want to use an app.
Export pages (e.g., as XML or PDF – for editing, XML is better).
Edit the exported content using a text editor with regex/bulk replace (like VS Code or Notepad++).
Re-import edited content using the Confluence Cloud REST API or manual page recreation.
Risks:
Manual process
Complex formatting might break
Not ideal for pages with attachments or embedded macros
Option 3: Use Confluence REST API (for Developers)
If you’re comfortable with code:
Use the Content Search API to find content containing the target string.
Use the PUT API to update pages with new content.
Basic steps:
Authenticate using an API token.
Search for pages by content or title.
Retrieve and modify page body.storage.value.
Update using PUT /wiki/rest/api/content/{id}.
Use a script (Python/Node.js) to automate this across many pages.
Option 4: Manual with Ctrl+F (for Small Sets)
If only a few pages are involved:
Open each page.
Use “Edit” → Ctrl+F to search and replace.
Save the page.
Best Practices
Backup pages before bulk-editing.
Test find/replace on a single page first.
Be cautious with macros, links, and formatting.
Would you like a ready-made API script (e.g., in Python) or more help using ScriptRunner?
Summary
Use Space Content Manager for Confluence find and replace across a single page, an entire space or multiple spaces. Find and delete text in Confluence, convert to UPPER or lower case in Confluence.