Forge app for Confluence Cloud · Upgrade Solutions
CQL Search for Confluence
CQL Search for Confluence runs one Confluence Query Language query as the person looking at the page, then shows the matches in a table. Put that table where the team already reads, or open the same search from Apps when you only need it once.
The search runs inside Atlassian. The app stores nothing of its own, and it does not send page content to an outside server. Updated .
Purpose
- A space index that stays current without someone rebuilding the list.
- Pages and attachments that have gone quiet.
- A personal list, such as pages you contributed to, embedded for the whole team.
- A one-off query from Apps when you do not want to edit a page.
Read the use cases for the query behind each of those.
Search
- Embed a search with the CQL Search macro. The query, columns, and page size are saved on the page.
- Open Apps and choose CQL Search for a search you do not need to keep.
On a page, currentSpace() and spaceKey() use that page’s space. currentContent() and pageId() use that page. Those four tokens are not available on the Apps page. currentUser() is left for Confluence in both places. The query guide has working examples.
Columns
Choose any of Title, Type, Space, Modified, and Creator. Title links to the content. Page size is 10, 25, or 50. Next and Previous move through a longer result set. Download CSV saves the rows on the current page, including a url column.
Limits
- It does not import another app’s macro. Paste the query into CQL Search.
- It does not save searches on the Apps page, build charts, or move pages in bulk.
- It does not export every match in one file. Download the page you are looking at, then go to the next page.
Price
Cloud pricing is monthly, and Atlassian bills it annually at ten times the monthly price. Multi-instance pricing uses the same rates.
| Users | Price | About a year |
|---|---|---|
| Up to 10 | $1.00 flat / month | $10 |
| 11–100 | $0.10 / user / month | $100 at 100 users |
| 101–250 | $0.08 / user / month | $200 at 250 users |
| 251–1,000 | $0.06 / user / month | $600 at 1,000 users |
| 1,001–2,500 | $0.05 / user / month | $1,250 at 2,500 users |
| 2,501–5,000 | $0.04 / user / month | $2,000 at 5,000 users |
| 5,001–7,500 | $0.03 / user / month | $2,250 at 7,500 users |
| 7,501 and up | $0.02 / user / month | $2,400 at 10,000 users |
Questions
What is CQL Search for Confluence?
CQL Search for Confluence is a Forge app from Upgrade Solutions. It runs one Confluence Query Language query as the person viewing the page and shows the matches in a table. You can embed that table on a page or open the same search from Apps.
How do I put CQL results on a Confluence page?
Edit the page, type /CQL Search, and insert the macro. Enter a CQL query, choose the columns, and choose a page size of 10, 25, or 50. Save the macro, then publish the page. The table loads for each viewer.
Does CQL Search send Confluence content outside Atlassian?
No. The app runs on Forge and calls Confluence search with the search:confluence scope. It has no external servers. The query, the columns, and the page size stay in the macro configuration on the page. The app does not keep a copy of the results.
Who can see the results?
Each person sees only the content Confluence already allows them to open. A search runs as the viewer, not as an app account. Two people opening the same page can see different rows.
What is the difference between the macro and the Apps page?
The macro saves a query on a page and can use that page for spaceKey(), currentSpace(), pageId(), and currentContent(). The Apps page is for a one-off search. Those four tokens are not available there. currentUser() is left for Confluence in both places.
Can I export every match?
Download CSV saves the rows on the current page of results, not the whole result set. Page through with Next and download again for the next set. The file includes the columns you selected, plus a url column.
What does CQL Search for Confluence cost?
Cloud pricing starts at $1 per month for up to 10 users, about $10 a year. After that the price is per user per month and steps down as the site grows: $0.10 through 100 users, $0.08 through 250, $0.06 through 1,000, $0.05 through 2,500, $0.04 through 5,000, $0.03 through 7,500, and $0.02 above that. Atlassian bills Cloud apps annually at ten times the monthly price. A 100-user site is about $100 a year. Multi-instance pricing uses the same rates.
Will it convert an older CQL Search macro for me?
No. Version 1 does not read another app’s macro configuration. Edit the page, insert CQL Search, and paste the query. An inactive license shows an upgrade message instead of results.
Support
Email tim@upgradesolutions.io. Include the query, the page URL, and what you expected to see.