Macro Find & Replace for Zendesk

Changed a link or a team name? Fix it in every macro at once.

Zendesk has no find and replace for macros. When your help center moves, a policy changes or a team gets a new name, someone opens every macro and edits it by hand. Here you type the old text and the new text, see every change before it happens, and update all the macros in one run.

You download a backup before anything is written, and the same page puts it all back if you need it.

Find and replace in Zendesk macros

1 Connect your Zendesk

How to make an API token (1 minute)
  1. In Zendesk, open Admin Center.
  2. Go to Apps and integrations, then APIs, then Zendesk API.
  3. Turn on Token access if it is off.
  4. Click Add API token, give it a name like "Macro find and replace", and copy it. Zendesk shows it only once.
  5. Paste it above with the email of an admin. When you are done, you can delete the token on the same page.

The email and token stay in this tab only and are gone when you close it. Zendesk does not accept API tokens straight from a web page, so each call goes through our small relay to your Zendesk and straight back. The relay only passes macro requests and does not store or log your token or your macros.

2 Which macros

Connect first. Your macros load here.

Categories come from the start of the title: "Billing::Refunds" is in Billing.

3 Find and replace

Look in

How it works

  1. Connect. Your Zendesk subdomain, an admin email and an API token. All your macros load, shared and personal.
  2. Narrow it down if you like. Active or inactive, one category, or titles with a word in them.
  3. Type the old text and the new text. Plain text by default, with match case, whole words and regular expressions when you need them. Pick where to look: titles, comments, rich-text comments, subjects, tags.
  4. Check the preview. Each macro shows the old and new text with the changed words marked, and how many matches it has. Untick any macro you want to leave alone.
  5. Download the backup, then apply. The Apply button only unlocks after the backup is downloaded. It holds every macro exactly as it is now.
  6. Changed your mind? Press Undo this run, or drop the backup file into the page any time later. It shows what goes back before it writes.

What it changes in Zendesk

Pricing

Free

$0

Loading macros and the preview are always free. Your first 10 macro updates are free for each Zendesk. Changing those macros again, or restoring them, stays free.

Editor Pass

$49 one payment

Unlimited macro updates and restores for 30 days, for one Zendesk subdomain. No subscription, nothing renews.

Prices in USD. Local VAT/GST is included or added at checkout by Paddle depending on your country. If it does not do the job for you, ask for a full refund within 14 days, see the terms.

Questions

Is my token stored?

No. The email and token stay in this browser tab (session storage) and are gone when you close it. Our relay passes each call to your Zendesk and back without saving or logging the token or your macros. What our server keeps, per Zendesk subdomain: how many free updates were used and the ids of those macros, for 365 days. With a pass: the subdomain it is tied to. In this browser: the record of your last run (macro ids, titles and their text before and after) so you can undo it, and your licence key if you bought one. A small cookie (ats_src) remembers which site sent you here, for our own sales counts.

Why does it need a relay at all?

Zendesk lets a web page call its API directly only with an OAuth sign-in, not with an API token. So the page sends each call to our relay, which only forwards reading macros and saving a macro's title, description and actions to your own subdomain.zendesk.com, and refuses everything else. When you are done you can delete the token in Admin Center.

Will it break the formatting of rich-text comments?

No. In rich-text comments it only looks at the words people read and at link addresses. Tags, styles and everything else in the HTML are left exactly as they were. One limit: a phrase split by formatting, like "Billing Squad", is two pieces of text and is not matched as one.

What about placeholders like {{ticket.requester.first_name}}?

They are left alone by default, so a search for "ticket" or "name" never breaks one. Untick "Leave {{placeholders}} alone" if you want to rename a dynamic content placeholder, for example {{dc.old_policy}} to {{dc.new_policy}}.

How do the backup and the restore work?

Before Apply unlocks, you download a JSON file with every macro that will change, exactly as it is now, plus what the run will write. To go back, press Undo this run or drop that file into the page later. The page compares each macro with the file: macros still as the run left them are ticked to go back; a macro someone edited since is shown unticked so you decide.

Which macros does it see?

Everything the user behind the token can see. For an admin that is every macro in the account, shared and personal, active and inactive. With an agent's token you would only see that agent's macros, so use an admin.

How fast is it?

Loading takes one call per 100 macros. Saving reads each macro once more, to be sure nobody changed it since the preview, then saves it. Zendesk allows 200 to 700 calls a minute depending on your plan; when it asks us to wait, the page waits and carries on. A few hundred macros take a few minutes. Keep the tab open until it says done.