How to find and replace text in Zendesk help center articles
By Jake Marsh · Updated
To find and replace text across your Zendesk help center, install Sprucewell, open it from the left navigation bar and go to Find and replace. Type what to find and what to replace it with, choose where to search, and click Find matches. Every translation with a match is listed, each match shown in context. Untick anything to leave alone, name the change and click Apply. Undo it any time from History.
Steps
- Type the text. Fill in what to find and what to replace it with. Leave Replace empty to remove the text.
- Set the options.
- Match case only matches the exact capitalization.
- Whole words skips matches inside longer words.
- Pattern treats the search as a regular expression. Use
$1,$2in the replacement for groups.
- Choose where to search (see the table below). Titles and Article text are on by default.
- Narrow it down by language, category, section, labels or status.
- Click Find matches. Each match shows the old text struck through and the new text highlighted. Untick a match, or a whole article, to leave it unchanged.
- Name the change. The name appears in History.
- Click Apply. Changes run one translation at a time. You can stop a run; whatever already changed is in History.
Where to search
| Option | What it changes | Use it for |
|---|---|---|
| Titles | Article titles | Renamed products and features |
| Article text | The words readers see in the body | Wording, names, phone numbers |
| Link addresses | The href of links | A website or file host that moved |
| Image addresses | The src of images | Images moved to a new host |
| HTML source (advanced) | The raw HTML, tags and attributes included | Changing markup; read the warnings |
In article text, Sprucewell never changes tag names, attributes, scripts or styles, and never turns your replacement into HTML. Markup only changes when you choose HTML source.
Examples
| Job | Find | Replace | Options |
|---|---|---|---|
| Rename a product | Acme Sync | Acme Connect | Titles, Article text, Match case |
| Move a domain | https://old.example.com | https://www.example.com | Link addresses, Image addresses |
| Update a version number | Version (\d+)\.x | Version $1 or later | Article text, Pattern |
When an article changes mid-run
Sprucewell re-reads each translation just before writing it. If someone saved it after your preview, it's skipped and listed under "Not changed". Search again to include it.
Undo
Open History, find the change by its name and click Undo to put back every item, or Show items and Undo this one for a single article. If an item was edited after Sprucewell's change, Undo skips it and offers Undo anyway, which overwrites the later edit. Undo copies are kept for 365 days by default (Keep undo copies for (days)).
Limits
- Default brand's help center only.
- Find and replace lists the first 5,000 matching translations. Narrow with filters for more.
- Changing an article needs a Guide admin, or an agent allowed to edit it. Zendesk refuses the rest and Sprucewell lists them as not changed.
What it costs
Sprucewell is billed monthly by Zendesk per Zendesk account, by article translations (an article in three languages counts three): Starter $85 a month for up to 2,000, Growth $125 for up to 6,000, Scale $175 for any number. Every feature is on every plan, with a 14-day free trial. See the Sprucewell documentation.
Sprucewell
Help center find and replace, broken links and 301 redirects across articles. Preview, then undo. From $85 a month per Zendesk account.
Questions
Can I replace text in every language at once?
Yes. Find and replace searches every translation unless you filter by language, and lists each language's matches separately.
Will it break links or formatting?
Not with the default options. Article text changes only the words readers see, and a < you type stays text. Link and image addresses are separate options you turn on.
Can I remove a phrase instead of replacing it?
Yes. Leave Replace empty and the matched text is removed.
Can I see who made a change?
Yes. History lists every change with its name, time and the person who made it.
More Sprucewell guides
- How to set up 301 redirects in a Zendesk help center
- How to find broken links in a Zendesk help center
More Zendesk guides
- How to show BambooHR employee info in Zendesk (Staffwell)
- How to add conditional text to a Zendesk macro (Slotwell)
- How to connect BaseLinker to Zendesk with an API token (Targwell for BaseLinker)
- How to pause or cancel a Recharge subscription from Zendesk (Skipwell)