Skip to content

Windows software and web scripts with one-time licenses. No subscriptions.

  User Guide

How to use Bulk Replace

Everything you need, in plain English - from your first find and replace to regular expressions, undo and saved projects.

New to Bulk Replace? See what Bulk Replace does, its features and price.

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

  1. 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.
  2. Click Next, accept the license agreement, choose where to install, then click Install and Finish.
  3. Bulk Replace opens with a short loading screen, then the main window. You can look around straight away.
  4. 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

The Bulk Replace window with numbered areas: header, folder box, preview list, before and after view, the Rules, Filters and Options tabs, and the bottom bar
Click any screenshot to see it bigger.
  • 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.

Back to top

Your first find and replace

Here's the whole job from start to finish. Nothing on your PC changes until step 5.

  1. 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.
  2. 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 with https://.
  3. Limit the files (optional). On the Filters tab, click Web to search only web pages, for example. See Choosing which files.
  4. Preview. Click Preview (or press F5). Every file with a match is listed. Click a file to see each change before and after.
  5. Replace. Click Replace All (n). Bulk Replace asks you to confirm, backs up each file, then makes the changes.
A finished preview listing files with their match counts and the before and after lines for the selected file

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.

Back to top

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.

The Rules tab with a list of three rules and the Edit rule box below with Find, Replace with and Match as

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

OptionWhat it does
Match as: Plain textFinds 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 expressionPowerful patterns for tricky jobs. See Regular expressions.
Match caseOnly matches the same capitals, so Apple won't match apple.
Whole wordOnly matches complete words, so cat won't match category.
Multi-lineLets 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).

Back to top

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.

  1. 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.
  2. Save it as a CSV file.
  3. 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....

Back to top

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

PatternMatches
.Any character (also line breaks when Multi-line is ticked).
\d \w \sA 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.
^ $ \bStart of a line, end of a line, edge of a word.
a|bEither a or b.

In the Replace box

WriteTo insert
$1 $2 (or \1)The text matched by group 1, 2...
${name}A named group.
$0The whole match.
$$A dollar sign.
\n \tA new line, a tab.

Examples

Find → Replace withResult
(\d{2})/(\d{2})/(\d{4}) → $3-$2-$131/12/2025 becomes 2025-12-31
http://(www\.)?example\.com → https://example.comMoves 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.

Back to top

Choosing which files

The Filters tab decides which files in the folder are searched.

The Filters tab with files to include, quick buttons, exclude boxes, attributes and size and date limits
SettingWhat it does
Files to includePatterns 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 filesPatterns to skip, e.g. *.min.js *.bak.
Skip folders namedFolders to leave out wherever they are, e.g. .git or node_modules.
Include hidden files and foldersAlso search files Windows hides.
Include system filesAlso search Windows system files.
Skip read-only filesLeave read-only files alone.
Smallest file / Largest fileOnly search files in this size range (in KB).
Modified on or after / on or beforeTick 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.

Back to top

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.

Back to top

Replacing

When the preview looks right, click Replace All (n) (Ctrl+R). The number is how many files and renames will change.

  1. Bulk Replace asks "Replace now?" with the number of matches and files. (You can turn this question off in Settings.)
  2. Each file is backed up, then changed. Its encoding and line endings are kept exactly as they were.
  3. Each row in the list shows its progress and result. The status line shows which file is being changed.
  4. When it's done you'll see a summary, e.g. 148 files changed - 1,291 matches replaced, with View Report, Undo and OK.
Bulk Replace part way through a run, with per-file progress bars and the Stop button

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 fileMeaning
n replacedThe file was changed.
Skipped - Nothing to changeAll its matches were unticked or the file changed since the preview.
Skipped - Read-onlyThe file is read-only and Skip read-only files is on.
Skipped - Binary fileIt isn't a text file.
ErrorThe file couldn't be changed. The reason is shown next to it and in the report.

Back to top

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:

SettingWhat it does
Text inside the filesReplace text in the files' contents (the usual job).
File namesApply the same rules to file names.
Folder namesApply the same rules to folder names.
Leave file extensions alone when renamingKeeps .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.

Back to top

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 window listing earlier runs with their folder, files, matches, renamed, errors and status

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.

Back to top

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 Change report window with a summary line and a table of every changed file
  • 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.

Back to top

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 itemWhat it does
File › New ProjectStart again with an empty rule (Ctrl+N).
File › Open Project...Open a saved .brproj file (Ctrl+O).
File › Recent ProjectsYour last few projects.
File › Save Project / Save Project As...Save the current job (Ctrl+S / Ctrl+Shift+S).
File › Choose Folder... / Recent FoldersPick 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.

Back to top

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.

Back to top

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.

Back to top

Settings

Open Settings › Default Settings.... Click Save to keep your changes, or Restore defaults to go back to the original settings.

The Bulk Replace settings window showing the General page

General

SettingWhat it does
Ask me to confirm before files are changedA final "Replace now?" check after you click Replace All. You always see the preview first.
Open the change report when a run finishesShows the change report after every run.
Reopen my last folder, filters and rules at start-upCarry on where you left off.
Show spaces and tabs in the previewShows 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.

SettingWhat it does
Save changed files asKeep 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 dateChanged files keep their old date.
Skip files larger thanVery large files are skipped (in MB; No limit to search them all).
Always skip these foldersFolder names to leave out of every search, e.g. .git; node_modules.

Backups & undo

SettingWhat it does
Backup folderWhere backups are kept, with how much space they use. Open shows the folder.
Keep backups for the last n runsOlder backups are deleted automatically (reports are kept). Set it to all to keep everything.
Run history...Opens the Run history.
Delete all backupsFrees the space. You can't undo past runs afterwards. Reports are kept.

Back to top

Keyboard shortcuts

KeysWhat it does
F5Preview changes
Ctrl+RReplace All
EscStop a preview or run
Ctrl+ZUndo the last run
Ctrl+HRun history
Ctrl+Shift+OChoose a folder
Ctrl+Shift+NAdd a rule
Ctrl+DDuplicate the selected rule
Ctrl+Up / Ctrl+DownMove the selected rule up or down
Ctrl+IImport rules from CSV
Ctrl+NNew project
Ctrl+OOpen a project
Ctrl+S / Ctrl+Shift+SSave project / Save project as
Alt+F4Exit

Back to top

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 Enter Installation Key window

The license row

The top right of the main window always shows your license status on one line:

You seeMeaning
License Invalid | Buy A License | Enter Installation KeyBulk Replace isn't activated on this PC yet, or the license needs attention. Replace All is paused.
LicensedEverything is unlocked. The purchase options are hidden.

Activating

  1. Click Enter Installation Key in the license row, or choose Settings › Enter Installation Key...
  2. Paste your key into the box. Dashes are added for you, so it doesn't matter if you copy it with or without them.
  3. 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 itemWhat 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 LicenseOpens 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"
The full message is "Your license needs attention. Invalid activation token for this hardware, replacing text is paused until it's resolved." It means this PC's activation is no longer valid, for example because it was deactivated, the license was refunded or expired, or Windows was reinstalled. Click Enter Installation Key and activate again. If that doesn't work, contact support.
"Maximum number of activations reached"
Your key is already active on all the PCs your license allows. Deactivate it on a PC you no longer use (Settings › Deactivate This PC...). If that PC isn't available any more, contact support and we'll reset it.
"License key not found" or "This key is for a different product"
Check the key was copied exactly from your purchase email, with no extra spaces. Each Easier Software title has its own key, so a key for another program won't activate Bulk Replace. A rejected key never uses up an activation.
"Could not reach the license server"
Activation needs an internet connection. Check you're online and that a firewall, antivirus or VPN isn't blocking Bulk Replace, then try again.

Back to top

Troubleshooting

"No matches found"
Check the Folder is right and tick Include sub-folders if the files are inside other folders. On the Filters tab, make sure Files to include covers your file types (click All to search everything) and that the size and date limits aren't leaving files out. Untick Match case and Whole word to see if they're too strict.
"Tick at least one of: file contents, file names, folder names."
Open the Options tab and tick Text inside the files (and/or File names or Folder names) so Bulk Replace knows what to change.
"Add at least one rule with something in the Find box."
Every rule is empty or turned off. Type something in Find on the Rules tab, and make sure the rule's tick box is ticked.
My regular expression shows a red error
The pattern has a mistake, such as a bracket that isn't closed. The message says what's wrong. To find a character that has a special meaning, like . ( 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
Look at the reason next to each file, or click View Report. Images, archives and programs are always skipped. Files bigger than the limit in Settings › Files & encoding, read-only files (if Skip read-only files is on) and files changed since the preview are skipped too.
A file says "Error" or "Access is denied"
Another program may have the file open, or your Windows account isn't allowed to change it. Close the program that's using it (for example your editor) and run Bulk Replace again on that folder. Files in protected places like C:\Program Files usually can't be changed.
Undo Last Run is grayed out
There's no run with a backup to undo. Either nothing has been replaced yet, the last run was already undone, the run had backups turned off, or its backup was removed because it was older than the number of runs kept (Settings › Backups & undo).
Accented letters look wrong after replacing
Undo the run. Then in Settings › Files & encoding (or the Options tab), set Save changed files as to Keep each file's own encoding and replace again. If the file was already wrong before, check which encoding your website or program expects (usually UTF-8).
The backup folder is getting big
Lower Keep backups for the last ... runs in Settings › Backups & undo, or click Delete all backups when you're sure you won't need to undo old runs.
The button says "Activate to Replace"
Bulk Replace isn't activated on this PC yet. Click it and enter your Installation Key. Your rules, filters and preview are kept, so you can replace straight away afterwards. See Your Installation Key.
Bulk Replace won't start
Restart your PC and try again. If it still won't start, reinstall it over the top (your settings and activation are kept). If that doesn't help, send us the log files from %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
Click More info then Run anyway. Some antivirus programs are cautious with new software; if yours blocks Bulk Replace, add it to the allowed list.
Where are my settings stored?
In %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.

Contact support

Back to top

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.

The Check for Updates window

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 itemWhat it does
Help › User GuideOpens this guide.
Help › Contact SupportOpens the Easier Software support page.
Help › Bulk Replace WebsiteOpens bulkreplace.com.
Help › More ApplicationsOur 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.

Back to top