Getting started
Bulk Replace changes text in hundreds or thousands of files in one go. You see every change before anything is written, every file is backed up first, and one click puts everything back.
What you need
- A Windows 10 (version 1809 or later) or Windows 11 PC, 64-bit.
- Your Installation Key from your purchase email (it looks like
XXXX-XXXX-XXXX-XXXX). - A folder of files you want to change (web pages, code, text, CSV and similar).
- If the files are on a website, download a copy to your PC first, change them there, then upload them again.
Install and activate
- Run BulkReplace-Setup.exe from your download page. If Windows shows "Windows protected your PC", click More info then Run anyway. This appears for software from smaller publishers.
- Click Next, accept the license agreement, choose where to install, then click Install and Finish.
- Bulk Replace opens with a short loading screen, then the main window. You can look around straight away.
- Click Enter Installation Key at the top right of the window (or Settings › Enter Installation Key...), paste your key and click Activate. See Your Installation Key.
Until Bulk Replace is activated you can choose folders, build rules and see the full before-and-after preview. Replace All needs an activated Installation Key.
A quick tour of the window
- 1Folder - the folder to search. Click Browse... or drop a folder on the window. Tick Include sub-folders to search everything inside it.
- 2Preview list - every file with a match and how many matches it has. During a run each row shows its own progress bar.
- 3Before / after - each change in the selected file, old line above, new line below. Untick a single match to leave it alone.
- 4Rules tab - what to find and what to replace it with. Add as many rules as you like.
- 5Filters and Options tabs - which files to include, and what to change (text, file names, folder names), encoding and backups.
- 6Status and progress - what Bulk Replace is doing, with a progress bar.
- 7Undo Last Run, View Report, Preview and Replace All (n). While a run is going, Replace All turns into Stop.
Your first find and replace
Here's the whole job from start to finish. Nothing on your PC changes until step 5.
- Choose a folder. Click Browse... next to Folder, or drag a folder onto the window. Tick Include sub-folders to search every folder inside it too.
- Add a rule. On the Rules tab, type what to look for in Find and the new text in Replace with. For example, find
http://and replace withhttps://. - Limit the files (optional). On the Filters tab, click Web to search only web pages, for example. See Choosing which files.
- Preview. Click Preview (or press F5). Every file with a match is listed. Click a file to see each change before and after.
- Replace. Click Replace All (n). Bulk Replace asks you to confirm, backs up each file, then makes the changes.
Not happy with the result? Click Undo Last Run and every file goes back exactly as it was. See Backups & undo.
Until Bulk Replace is activated, the big button reads Activate to Replace. You can still choose folders, build rules and see the full preview. Undo always works.
Find & replace rules
The Rules tab holds your list of rules. They run in order, top to bottom, in a single pass through each file. The count at the top shows how many are active, e.g. 2 of 3 active.
Adding and editing rules
- Click Add Rule, then fill in Find and Replace with in the Edit rule box underneath.
- Leave Replace with empty to remove the text you're finding.
- Click a rule in the list to edit it. The tick box at its left turns the rule on or off without deleting it.
- The small buttons under the list duplicate, remove, and move the selected rule up or down.
- Press Enter inside the Find or Replace box to add a line break. Line breaks in the Find box match line breaks in your files.
Rule options
| Option | What it does |
|---|---|
| Match as: Plain text | Finds exactly what you typed. |
| Match as: Wildcards ( * ? ) | * matches any text and ? matches one character. Use $1, $2... in Replace to keep what each wildcard matched. Example: find <b>*</b>, replace with <strong>$1</strong>. |
| Match as: Regular expression | Powerful patterns for tricky jobs. See Regular expressions. |
| Match case | Only matches the same capitals, so Apple won't match apple. |
| Whole word | Only matches complete words, so cat won't match category. |
| Multi-line | Lets wildcards and the regex . match across line breaks, for text that spans several lines. |
If a rule has a mistake (for example a broken regular expression), the message under the Edit rule box turns red and tells you what's wrong.
Ready-made example rules
Rules › Add an Example Rule adds a working rule you can learn from or change:
- Move a site from http to https
- Dates dd/mm/yyyy → yyyy-mm-dd
- Rename a brand (whole word)
- Remove trailing spaces
- Remove HTML comments
- Update a copyright year
<b>...</b>→<strong>...</strong>
Rules › Clear All Rules empties the list (Bulk Replace asks first).
Importing rules from a spreadsheet
Got a long list of changes, such as old and new product codes? Put them in a spreadsheet and import them all at once.
- In Excel (or any spreadsheet), put the text to find in the first column and the replacement in the second. A header row is optional.
- Save it as a CSV file.
- Click Import CSV on the Rules tab, or choose Rules › Import Rules from CSV... (Ctrl+I). You can also drop the CSV file onto the window.
Optional extra columns set each rule's options: mode (text, wildcard or regex), match_case, whole_word and multiline.
To save your rules as a CSV, click the export button next to Import CSV, or choose Rules › Export Rules to CSV....
Regular expressions
Set a rule's Match as to Regular expression to match patterns rather than fixed text. Matching ignores capitals unless Match case is ticked. ^ and $ match at the start and end of every line.
Patterns
| Pattern | Matches |
|---|---|
. | Any character (also line breaks when Multi-line is ticked). |
\d \w \s | A digit, a word character, a space or tab. |
[abc] [^abc] | One of these characters / any character except these. |
* + ? {2,4} | Repeat 0 or more, 1 or more, 0 or 1, 2 to 4 times. Add ? for the shortest match. |
( ) | A group you can reuse in Replace. |
^ $ \b | Start of a line, end of a line, edge of a word. |
a|b | Either a or b. |
In the Replace box
| Write | To insert |
|---|---|
$1 $2 (or \1) | The text matched by group 1, 2... |
${name} | A named group. |
$0 | The whole match. |
$$ | A dollar sign. |
\n \t | A new line, a tab. |
Examples
| Find → Replace with | Result |
|---|---|
(\d{2})/(\d{2})/(\d{4}) → $3-$2-$1 | 31/12/2025 becomes 2025-12-31 |
http://(www\.)?example\.com → https://example.com | Moves links to https |
[ \t]+$ → (empty) | Removes spaces at the end of lines |
Always check the preview after writing a new pattern. If it matches more than you expected, untick the matches you don't want or adjust the pattern and click Preview again.
Choosing which files
The Filters tab decides which files in the folder are searched.
| Setting | What it does |
|---|---|
| Files to include | Patterns such as *.html *.css *.php. Leave it empty for all files. The quick buttons fill it in for you: Web, Code, Data, Docs, Config and All. |
| Exclude files | Patterns to skip, e.g. *.min.js *.bak. |
| Skip folders named | Folders to leave out wherever they are, e.g. .git or node_modules. |
| Include hidden files and folders | Also search files Windows hides. |
| Include system files | Also search Windows system files. |
| Skip read-only files | Leave read-only files alone. |
| Smallest file / Largest file | Only search files in this size range (in KB). |
| Modified on or after / on or before | Tick and pick a date to only search files changed in that period. |
Separate patterns with spaces or semicolons. Images, archives, programs and other non-text files are always detected and skipped, so you can't damage them by accident.
The before & after preview
Click Preview (F5) any time. Bulk Replace searches the folder and lists every file with a match, but writes nothing.
- The line above the list shows the totals, e.g. 148 files - 1,291 matches, and how many are ticked if you've unticked some.
- Click a file to see each change in the Before / after area: the old line (marked -) and the new line (marked +), with the file's encoding and line endings.
- Untick a file in the list to leave the whole file alone. Tick all and Untick all above the list do every file.
- Untick a single match in the Before / after area to skip just that one change. The buttons next to it tick or untick every match in the file.
- Open file opens the selected file in its usual program.
If you change a rule, a filter or an option after previewing, the count line says settings changed - preview again. Replace All always previews again first, so what you replace always matches your current settings.
When nothing matches you'll see "No matches found" with how many files were searched. Check your rules and the Filters tab.
Turn on Show spaces and tabs in the preview in Settings to see exactly where spaces and tabs are.
Replacing
When the preview looks right, click Replace All (n) (Ctrl+R). The number is how many files and renames will change.
- Bulk Replace asks "Replace now?" with the number of matches and files. (You can turn this question off in Settings.)
- Each file is backed up, then changed. Its encoding and line endings are kept exactly as they were.
- Each row in the list shows its progress and result. The status line shows which file is being changed.
- When it's done you'll see a summary, e.g. 148 files changed - 1,291 matches replaced, with View Report, Undo and OK.
To stop part way, click Stop (or press Esc). Files already changed stay changed and are backed up, so Undo Last Run can still put them back.
| Result next to a file | Meaning |
|---|---|
| n replaced | The file was changed. |
| Skipped - Nothing to change | All its matches were unticked or the file changed since the preview. |
| Skipped - Read-only | The file is read-only and Skip read-only files is on. |
| Skipped - Binary file | It isn't a text file. |
| Error | The file couldn't be changed. The reason is shown next to it and in the report. |
Renaming files & folders
Your rules can change file and folder names too, in the same run or on their own. Open the Options tab and look under What to change:
| Setting | What it does |
|---|---|
| Text inside the files | Replace text in the files' contents (the usual job). |
| File names | Apply the same rules to file names. |
| Folder names | Apply the same rules to folder names. |
| Leave file extensions alone when renaming | Keeps .html, .jpg and so on unchanged. Untick only if you mean to change extensions. |
Renames appear in the preview after the files, so you can check and untick them. Before anything happens Bulk Replace flags any rename that would clash with an existing name, leave a name empty, use a character Windows doesn't allow, end with a space or dot, or use a reserved Windows name.
Backups & undo
With Back up every file before changing it ticked on the Options tab (it's on unless you turn it off), every file is copied before it's changed. That means any run can be undone.
- Undo the last run: click Undo Last Run (Ctrl+Z) and confirm. Every changed file is put back and every rename is reversed.
- Undo an older run: open the Run history (Ctrl+H, or the Run history... button in Settings), pick the run and click Undo This Run.
- If you've edited some of the files since the run, Bulk Replace lists them and asks before replacing your newer edits with the originals (Restore Anyway).
The Run history lists every run with its date, folder, files, matches, renames, errors and status (Completed, Stopped or Undone). View Report opens its change report and Open Backup Folder shows its backup copies.
If you untick the backup option, changes to file contents can't be undone. Renames can still be undone.
Backups are kept for the last 30 runs by default. Older ones are deleted automatically, but their reports are kept. Change this in Settings › Backups & undo.
Change reports
Every run writes a report listing every file it changed, skipped or couldn't change. Click View Report at the bottom of the window to see the last one.
- The top line sums up the run: files changed, matches replaced, renamed, skipped, errors and how long it took.
- The table shows each file with the time, action, path, new path, matches, encoding and result.
- Open in Excel opens the report (it's a CSV file) and Save a Copy... saves it wherever you like.
Tick Open the change report when a run finishes in Settings to see it automatically after every run.
Saving jobs as projects
Do the same job every month? Save it as a project. A project keeps the folder, filters, options and every rule.
| Menu item | What it does |
|---|---|
| File › New Project | Start again with an empty rule (Ctrl+N). |
| File › Open Project... | Open a saved .brproj file (Ctrl+O). |
| File › Recent Projects | Your last few projects. |
| File › Save Project / Save Project As... | Save the current job (Ctrl+S / Ctrl+Shift+S). |
| File › Choose Folder... / Recent Folders | Pick the folder to search (Ctrl+Shift+O). |
The project's name shows in the title bar, with a * when it has unsaved changes. Bulk Replace asks before closing a project with unsaved changes.
Double-click a .brproj file in Windows Explorer to open it straight in Bulk Replace. You can also drag one onto the window.
Starting from Windows Explorer
The installer adds Bulk Replace to the right-click menu for folders. In Windows Explorer, right-click a folder and choose Find and replace with Bulk Replace. Bulk Replace opens with that folder already chosen.
On Windows 11 the entry may be under Show more options.
You can also drag a folder, a project file or a rules CSV onto the Bulk Replace window at any time.
Encodings & line endings
Bulk Replace reads each file the way it was saved and writes it back the same way, so accented letters and symbols stay correct.
- UTF-8, UTF-8 with BOM, UTF-16 and ANSI (Windows code page) files are detected automatically.
- Line endings (Windows CRLF or Unix LF) are always kept as they are.
- Each file's encoding is shown above its changes in the preview.
On the Options tab, Save changed files as can convert every changed file to one encoding: Keep each file's own encoding (the default), UTF-8, UTF-8 with BOM, UTF-16 LE or ANSI. Keep each file's original modified date leaves the file date unchanged, which can help with backup or sync tools.
Settings
Open Settings › Default Settings.... Click Save to keep your changes, or Restore defaults to go back to the original settings.
General
| Setting | What it does |
|---|---|
| Ask me to confirm before files are changed | A final "Replace now?" check after you click Replace All. You always see the preview first. |
| Open the change report when a run finishes | Shows the change report after every run. |
| Reopen my last folder, filters and rules at start-up | Carry on where you left off. |
| Show spaces and tabs in the preview | Shows spaces as dots and tabs as arrows in the Before / after area. |
Files & encoding
These are the defaults for new projects. Each project can still change them on its Filters and Options tabs.
| Setting | What it does |
|---|---|
| Save changed files as | Keep each file's own encoding, or convert to UTF-8, UTF-8 with BOM, UTF-16 LE or ANSI. |
| Keep each file's original modified date | Changed files keep their old date. |
| Skip files larger than | Very large files are skipped (in MB; No limit to search them all). |
| Always skip these folders | Folder names to leave out of every search, e.g. .git; node_modules. |
Backups & undo
| Setting | What it does |
|---|---|
| Backup folder | Where backups are kept, with how much space they use. Open shows the folder. |
| Keep backups for the last n runs | Older backups are deleted automatically (reports are kept). Set it to all to keep everything. |
| Run history... | Opens the Run history. |
| Delete all backups | Frees the space. You can't undo past runs afterwards. Reports are kept. |
Keyboard shortcuts
| Keys | What it does |
|---|---|
| F5 | Preview changes |
| Ctrl+R | Replace All |
| Esc | Stop a preview or run |
| Ctrl+Z | Undo the last run |
| Ctrl+H | Run history |
| Ctrl+Shift+O | Choose a folder |
| Ctrl+Shift+N | Add a rule |
| Ctrl+D | Duplicate the selected rule |
| Ctrl+Up / Ctrl+Down | Move the selected rule up or down |
| Ctrl+I | Import rules from CSV |
| Ctrl+N | New project |
| Ctrl+O | Open a project |
| Ctrl+S / Ctrl+Shift+S | Save project / Save project as |
| Alt+F4 | Exit |
Your Installation Key
Your Installation Key is in your purchase email and on your download page. It looks like XXXX-XXXX-XXXX-XXXX. It activates Bulk Replace on your PC. One key works on the number of PCs your license allows.
The license row
The top right of the main window always shows your license status on one line:
| You see | Meaning |
|---|---|
| License Invalid | Buy A License | Enter Installation Key | Bulk Replace isn't activated on this PC yet, or the license needs attention. Replace All is paused. |
| Licensed | Everything is unlocked. The purchase options are hidden. |
Activating
- Click Enter Installation Key in the license row, or choose Settings › Enter Installation Key...
- Paste your key into the box. Dashes are added for you, so it doesn't matter if you copy it with or without them.
- Click Activate. You need to be online for this. Everything unlocks straight away, with no restart.
For your security, once a key has been entered it's only ever shown with the middle hidden, for example ABCD-XXXX-XXXX-WXYZ.
The Settings menu
| Menu item | What it does |
|---|---|
| Enter Installation Key... | Activate Bulk Replace on this PC. |
| Check License Status... | Shows your key (partly hidden), who it's licensed to, the license type, the expiry date if there is one, and how many of your PCs are using it. |
| Deactivate This PC... | Frees this PC's activation so you can use the key on another PC. Your license stays valid. |
| Buy License | Opens the Bulk Replace website to buy a license. Hidden once you're licensed. |
Moving to a new PC
On the old PC choose Settings › Deactivate This PC..., then install Bulk Replace on the new PC and activate it with the same key. If the old PC has died or been wiped, contact support and we'll free the activation for you.
Working offline
Bulk Replace checks your license quietly each time it starts and once a day while it's open. If your PC is offline, or the license service can't be reached, it keeps working normally for 7 days and checks again when you're back online.
"Your license needs attention"
"Maximum number of activations reached"
"License key not found" or "This key is for a different product"
"Could not reach the license server"
Troubleshooting
"No matches found"
"Tick at least one of: file contents, file names, folder names."
"Add at least one rule with something in the Find box."
My regular expression shows a red error
. ( or ?, put a backslash in front of it: \.. Or set Match as to Plain text if you don't need a pattern.Some files were skipped
A file says "Error" or "Access is denied"
C:\Program Files usually can't be changed.Undo Last Run is grayed out
Accented letters look wrong after replacing
The backup folder is getting big
The button says "Activate to Replace"
Bulk Replace won't start
%APPDATA%\Easier Software LLC\Bulk Replace (paste that into the Windows Explorer address bar to open it).Windows SmartScreen or my antivirus warns about the installer
Where are my settings stored?
%APPDATA%\Easier Software LLC\Bulk Replace on your PC. Uninstalling leaves this folder in place, so a reinstall keeps your settings and activation.Still stuck?
We're happy to help. Tell us what you were doing and what the message said.
Updating & uninstalling
Checking for updates
Updates are free. Choose About › Check for Updates.... Bulk Replace checks the website (it takes a few seconds) and tells you if you're up to date or if a newer version is available, with a button to download it. Run the new installer over the top of your current version; your settings and activation are kept.
If it says "Couldn't check for updates", you're probably offline. Try again later, or visit bulkreplace.com.
The Help and About menus
| Menu item | What it does |
|---|---|
| Help › User Guide | Opens this guide. |
| Help › Contact Support | Opens the Easier Software support page. |
| Help › Bulk Replace Website | Opens bulkreplace.com. |
| Help › More Applications | Our other Windows software. |
| About › About Bulk Replace... | Version number, license status and links. |
| About › Check for Updates... | See above. |
Uninstalling
If you're moving to a new PC, deactivate first (Settings › Deactivate This PC...). Then open Windows Settings › Apps, find Bulk Replace and click Uninstall. Your settings stay in %APPDATA%\Easier Software LLC\Bulk Replace in case you reinstall; delete that folder to remove them too. Your own files are never touched.
