How can I search for pages that have the Pages Properties macro in Confluence?
Asked by Victoria Reggiardo:

I need to search for all pages that include the Pages Properties macro. I tried: macroName:page-properties but returned no results (I know for a fact that there should have returned lots of pages).

Any ideas?

Thanks!


Answers:
author: Jonathan Smith
body: [@Victoria Reggiardo](/t5/user/viewprofilepage/user-id/1180109) ,

You can see how many pages use this macro from the Confluence admin console:

1. Cog wheel, general configuration
2. Macro Usage
3. Scroll down to Page Properties Macros
4. ![a.jpg](https://community.atlassian.com/t5/image/serverpage/image-id/48676iA1E633F40F3B6F86/image-size/large?v=v2&px=999 "a.jpg")

It looks like those items are clickable.. hope this helps.

- Jonathan

comments: author: Jonathan Smith
body: When clicking the 'details', it will take you to a search results screen. From here, you will need to filter down to what you want to see.


author: Victoria Reggiardo
body: Thanks so much [@Jonathan Smith](/t5/user/viewprofilepage/user-id/1254033) . Unfortunately, I'm not a Confluence admin, I was looking for a way in which a regular user can obtain such info.


author: Jonathan Smith
body: [@Victoria Reggiardo](/t5/user/viewprofilepage/user-id/1180109)

Try this link:

https://**yourconfluenceURL**/dosearchsite.action?cql=macro+%3D+%22details%22

- Jon


author: Jonathan Smith
body: Anxiously awaits [@Victoria Reggiardo](/t5/user/viewprofilepage/user-id/1180109) to try the link above.

![dp.gif](https://community.atlassian.com/t5/image/serverpage/image-id/48687i36AB334C56200C30/image-size/large?v=v2&px=999 "dp.gif")


author: Victoria Reggiardo
body: Hey [@Jonathan Smith](/t5/user/viewprofilepage/user-id/1254033), it works!!


author: Jonathan Smith
body: [@Victoria Reggiardo](/t5/user/viewprofilepage/user-id/1180109)

Sweet! We both learned something today!

If you are satisfied with the answer, please vote and accept this thread.

Thanks,

Jon


author: Victoria Reggiardo
body: I'm sorry but I'm not a coder at all, what should I change if I want to search for another macro?


author: Victoria Reggiardo
body: Actually, what part of the URL defines the Page Properties macro?


author: Jonathan Smith
body: https://yourconfluenceURL/dosearchsite.action?cql=**macro+%3D+%22details%22**

* Assuming **cql** means confluence query language

Other examples:

**Attachments macro** https://yourconfluenceurl/dosearchsite.action?cql=**macro+%3D+%22attachments%22**

**Info macro**   
https://yourconfluenceurl/dosearchsite.action?cql=**macro+%3D+%22info%22**

Your admin should be able to supply the desired URLs for other macros if needed.

- Jon


author: Jonathan Smith
body: I don't think your going to be able to 100% guess the URLs. Some like page properties macro say "details" in the URL..


author: Victoria Reggiardo
body: [@Jonathan Smith](/t5/user/viewprofilepage/user-id/1254033) , that's great. This is really helpful, thanks!


author: Fabienne Gerhard
body: Thanks [@Jonathan Smith](/t5/user/viewprofilepage/user-id/1254033) an option for admin I didn't use yet :) - maybe a tip for everyone using macroName: *nameofmacro\**check out the correct name of the macro with your browser using F12 cause search is really really a \*miau\* here ;)


author: Jonathan Smith
body: Hi [@Victoria Reggiardo](/t5/user/viewprofilepage/user-id/1180109) ,

What is your purpose for searching for pages with this macro?

Reminder: Page Properties Report macro + page label would populate a dashboard with contents from those desired pages.

- Jon

comments: author: Victoria Reggiardo
body: [@Jonathan Smith](/t5/user/viewprofilepage/user-id/1254033)

We want to know the number of pages that use that specific macro.


author: Jonathan Smith
body: Note: Since your search had special characters, you might have to put quotes around that.


author: Victoria Reggiardo
body: [@Jonathan Smith](/t5/user/viewprofilepage/user-id/1254033)

Thanks for your reply, **macroName:"page-properties"**is not working either.


author: Liza Top
body: Way too late for the original question, but I'll add it for future Googlers. Use the following in a search field:

macroName:details\*

The technical name of the page properties macro is "details" not "page-properties". The \* is needed to prevent possible search problems. See <https://confluence.atlassian.com/doc/confluence-search-syntax-158720.html>

Tested and used in Confluence Server 7.8.3


Tags: confluence-server

server