Query & Bulk Actions for Confluence
Write a Confluence search in plain English, with a builder or in CQL, and check it before it runs. Save it and share it with your team, show its live results on any page, and change the results in bulk: add, remove, rename or merge labels, watch pages, or archive them, always with a preview first.
space = "HR" AND type = page AND lastmodified < now("-1y")Illustration with made-up data
What it does
Confluence's own search is made for finding one page. When you need every page that matches a rule, and then want to do something to all of them, Query & Bulk Actions gives you the search language Confluence already has (CQL) in a form you can check, keep and act on.
Check the search first
Type what you want in plain English, or use the builder, and see the exact CQL and a one-line description before anything runs. Change it, then press Run.
Save and share
Keep searches for yourself or share them with your site. Everyone runs a shared search as themselves, so they only ever see what they're allowed to.
Live results on any page
The Query results macro shows a search's results on a page, with the columns, sort and number of rows you choose. Each reader sees their own results.
Labels in bulk
Add or remove labels on up to 500 pages, blog posts and files at a time, or rename or merge a label across the whole site.
Watchers and archive
Watch or stop watching many pages at once, for yourself or (as an admin) for someone else. Archive up to 300 pages in one run.
Preview, results and undo
Every change shows a preview first, then a result for each item: done, skipped, refused or failed. Label and watcher changes can be undone.
Careful by design
A tool that changes many pages at once has to be careful about who can do what.
- Runs as you. Searches and changes run in your browser as you, so you see only what you can open and change only what Confluence lets you change. Pages you can't edit are refused, never changed.
- A preview before every change. Nothing changes until you've seen what will happen and confirmed it. Archiving needs a second tick.
- Nothing is ever deleted. The app adds and removes labels and watchers and archives pages. Archived pages can be restored in Confluence.
- Nothing leaves Atlassian. The app runs on Atlassian Forge and makes no calls to outside services. “Ask in plain English” uses an AI model hosted by Atlassian and never sees page content. No analytics or tracking.
Pricing
Free for sites with up to 10 users. Larger sites pay per user through the Atlassian Marketplace, billed by Atlassian with your other apps. Every plan includes every feature, and you can try it free first.
Requirements
- Confluence Cloud (the app is not available for Data Center)
- A Confluence admin to install it; anyone can use it
- Archiving needs Confluence Standard, Premium or Enterprise (Confluence Free doesn't include archiving)
Help and FAQ
1. Getting started
- A Confluence admin installs Query & Bulk Actions from the Atlassian Marketplace (in Confluence: Apps → Explore more apps).
- Anyone on the site can then open it from the Apps menu → Query & Bulk Actions. The first time, Confluence asks you to allow access.
- Write a search (see below), press Run, and the results appear underneath. Tick results to change them.
Tip: start with the builder. It writes the CQL for you, and you can see exactly what it wrote in the CQL box.
2. Writing a search
There are three ways to write a search, and you can switch between them:
- Ask in plain English: type what you're looking for and press Write the search. The app fills in the builder (or the CQL box) and describes the search in one line. Nothing runs until you press Run.
- Build a search: pick spaces, types, labels, people, dates, words in the title or text, or a page to search under.
- CQL: type Confluence Query Language yourself, for anything the builder doesn't offer.
currentUser()works here. When you edit the CQL by hand, the builder switches off until you press Reset to builder.
Results show only what you're allowed to see. Choose the columns (title, type, space, dates, people, labels, version, parent, file size), the number of rows, and sort by clicking a column heading. Export CSV saves the results to a file, up to 10,000 rows.
If you change the search after running it, the page says so, and ticking and bulk changes wait until you press Run again, so a change never goes to results you no longer mean.
3. Ask in plain English and AI
- Type what you're looking for, for example pages about onboarding that HR hasn't updated in a year. The app writes a CQL search and shows it, with a short description, before anything runs. Check it, change it if needed, then press Run.
- It's optional: the builder and the CQL box work the same with or without it.
- What's sent: your request, today's date, the search fields the app allows, the names of spaces you can see and the names of up to 20 labels that share a word with your request. Never page content, page titles or people. It goes to an AI model hosted by Atlassian, inside Atlassian's platform (Forge LLMs), and Kitefold doesn't store or log what you type.
- What Atlassian does with it: Atlassian has confirmed that requests and answers aren't stored by Atlassian or the model provider, are used only to answer that request, and are never used to train AI models. Requests are processed in one region for now, wherever your data is stored; Atlassian plans to let organisations choose where AI requests are processed (such as within the EU), and the app will follow that setting once it's available. See the privacy policy.
- People by name: if your request names someone, the app asks you to pick the person before the search runs.
- Monthly allowance: each site has a monthly number of plain-English searches, shared by everyone and shown next to the button. On paid sites it's 50 for each person who uses the feature that month (at least 500, up to 2,500); on free sites 20. A spending cap on the AI (15 cents for each person using it, at least $1.50) stops runaway use; normal use never gets near it. Every request counts, including one it can't turn into a search. When it's used up, the builder and the CQL box still work, and it starts again on the 1st of the month.
- Short labels: write two-letter labels in capitals, like HR or IT, so they're matched to the labels
hrandit; ordinary words like “it” or “in” aren't. - “Couldn't turn that into a search”: try rewording it, or use the builder. Some things can't be searched with CQL, such as likes or page views.
4. Saved searches
- Press Save this search…, give it a name, and choose whether to share it with everyone on the site. The search's columns, sort and number of rows are saved with it.
- Show saved searches lists your own searches and the site's shared ones. Open one to load it into the page; if you change it, the page says so and offers to save the changes or save it as a new search.
- Anyone can run and copy a shared search; it always runs as the person using it. Only the person who saved it can change or delete it, and Confluence admins can too (it then shows “edited by” with their name).
5. The Query results macro
- Edit a page, type
/and choose Query results. - In its settings, pick a saved search or write a search in CQL, then choose the columns, sort, number of rows (10 to 100), an optional title, and whether to show the result count and the search itself.
- Publish the page. Each person who views it sees the results they're allowed to see.
- In the macro,
pageId()andspaceKey()stand for the page the macro is on and its space (as in the CQL Search app), so one search can be reused on many pages. - Results load once each time the page is opened, never on a timer. For a few minutes after that, the same person sees the same results straight away, marked “Results from” and the time.
- Open in Query & Bulk Actions opens the search page with the same search, to export it or change the results.
- If a saved search used in a macro is deleted or made private, the macro says so. Edit the macro and pick another search, or write the search into it.
6. Changing results in bulk
- Tick results (or press Select all, up to 500 at a time), choose an Action, and press Preview.
- The preview says how many items will change, which will be skipped and why, and lists the first 20 titles. Press the button to confirm.
- The run changes 4 items at a time, as you, and shows its progress. Keep the tab open until it finishes; Stop stops it between items.
- Each item then shows Done, Skipped (for example it already had the label), Refused (Confluence didn't allow it, usually because you can't edit that page) or Failed (with Confluence's message). Download results (CSV) saves the list.
| Action | What it does |
|---|---|
| Add labels / Remove labels | On the ticked pages, blog posts and files. Only labels the item needs to gain or lose are changed. |
| Rename or merge a label (whole site) | Finds everything with the old label (or several, to merge them) that you can see, in every space, up to 500 at a time. Each item gets the new label first, then loses the old one. The preview names the spaces it will change. Find the next ones carries on with the rest. |
| Watch / Stop watching | For you, or for someone else. Confluence only lets Confluence admins and space admins change someone else's watching; for anyone else the run stops at the first refusal. Someone added as a watcher isn't notified that you did it. |
| Archive pages | Moves the ticked pages to their space's archive. See Archiving pages. |
- Undo: after a label or watcher run, Undo these changes reverses exactly what that run changed, whatever search is on screen. It's kept in the open tab only, so it's gone after a reload.
- If Confluence is busy, the run slows to one item at a time and may pause. Run the rest carries on with the items not started.
- If you leave the page during a run, it stops. The next time you open the app it says how far it got; run the same change again to finish (items already changed are skipped).
7. Archiving pages
- Archive works on pages only (not blog posts or files), up to 300 a run, and needs a second tick before it starts. The app can't undo an archive.
- Who can archive is Confluence's rule: anyone with the space's Archive permission can archive any page they can view, even one that's restricted from editing, and everyone can archive pages they created. Space admins choose who has the Archive permission in the space's settings. The app allows exactly what Confluence allows.
- Premium and Enterprise sites archive the whole run as one Confluence job. Standard sites archive one page at a time, so it takes a little longer; Stop works between pages. Confluence Free doesn't include archiving.
- To restore a page, open it and choose Restore. It goes back under its last parent page. Rows in the results link to each archived page.
8. The admin setting
In Confluence Settings → Apps → Query & Bulk Actions, a Confluence admin can choose whether the bulk bar is Shown (the default) or Hidden on the search page. With Hidden, searching, saved searches, export and the macro still work.
This is a preference for your team, not a security setting: every action runs as the person using it, so nobody can change a page they couldn't change by hand, whatever this setting says. The same page shows how often Confluence asked the app to slow down this week.
9. Limits and large sites
Every action has a fixed size, so the app works the same on a site with 3,000 pages or a million: a screen of up to 100 results, Select all up to 500, a bulk run up to 500 items (300 for archive), an export up to 10,000 rows. It never reads your whole site.
- Your site's hourly allowance: to keep Confluence fast for everyone, each site has an hourly allowance for the app. Normal use never reaches it. If a very busy site does, searching or big actions wait until the time shown.
- Atlassian's shared limit: Atlassian limits how much all sites together can ask of an app. If it's nearly used, big actions (export, Select all, bulk changes) wait until the time shown while searching still works; if it's used up, searching waits too, usually for a few minutes. The message says when to try again.
- Speed: a search usually takes a second or two; an export runs at about 170 rows a second. The first time the page or a macro opens, Confluence takes a few seconds to load the app.
10. Common questions
Why does it ask me to “Allow access”?
This is normal and happens once per person. Apps built on Atlassian Forge must ask before they work in Confluence on someone's behalf. Query & Bulk Actions runs every search and every change as you, which is what keeps everything you can't open out of view. Press Allow access.
Why do two people see different results for the same search?
Each person sees only the pages they're allowed to open. Shared searches and the macro run as whoever is looking, so their results can differ.
Some items were Refused. Why?
Confluence refused the change, usually because you can view the page but not edit it, or you tried to change someone else's watching without being an admin. Nothing was changed on those items.
Can it delete pages or labels for good?
No. It adds and removes labels on items, changes watching and archives pages. It never deletes pages, files or anything else, and archived pages can be restored.
We use CQL Search or Bulk Action Tools. Will our searches work?
CQL is Confluence's own search language, so the same searches work here. In the macro, pageId() and spaceKey() work as they do in CQL Search. Paste a search into the CQL box, check the results, then save it or put it in a Query results macro.
The app says the licence isn't active
The app needs an active licence on your site (it's free for sites with up to 10 users). A Confluence admin can check or renew it under Apps → Manage apps. Your saved searches are kept meanwhile.
What happens if we uninstall the app?
Atlassian deletes what the app stored on your site (saved searches, the admin setting and its usage counts) under its retention rules for Forge apps; if you install the app again within 21 days, Atlassian can restore it. Nothing in Confluence itself changes: labels, watchers and archived pages stay as they are. Query results macros on pages stop showing results until the app is installed again.
11. Contact support
Email support@kitefold.app. We reply within one working day (Monday to Friday, 9:00 to 17:00 UK time), and the same working day for urgent problems: see support hours and response times. It helps to include your Confluence site address, the search you ran (the CQL), what you expected and what happened, with a screenshot if you can.
Please don't send passwords or API tokens. We'll never ask for them.