Search Results Macro

Add the Search Results macro to a page to display the results of a pre-defined search.

Add this macro to your page

Error rendering macro 'includeplus'

User 'anonymous' does not have permission to view the page with ID 967875902.

Change the macro parameters

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

Here's a list of the parameters available in this macro. 




Search Terms


The search terms which this macro will use to generate its results.

You can refine your search query by using operators such as 'AND' and 'OR'. For example: my_query1 AND my_query2

For more information, take a look at the documentation on the Confluence search syntax.

Maximum Number of Results


Set a limit to the number of search results displayed.

Restrict to this Space Key


Start typing the space name to find the space, or specify the key of the space you want to search in. Note that the key is case sensitive.

Content Type


Specify the content type. The content types are: page, comment, blogpost, attachment, userinfo (the content of user profiles only) and spacedesc (the content of space descriptions only).

Last Modified


Specify a period of time in weeks, days, hours and/or minutes, to see the content modified within that time frame.

These are the values you can use:
  • w = weeks
  • d = days
  • h = hours
  • m = minutes

For example:

  • 2h 35m
  • 3d 30m


  • If no time category is specified, Confluence assumes minutes.
  • If you specify more than one time period (for example, weeks and days), you must separate the periods with a space. You can put them in any order.
  • The time categories are not case sensitive. For example, '4d' is the same as '4D'.

Restrict to this Username


Specify the username of a Confluence user, to show only content created or updated by that user.


Permissions: When a user views the page containing the Search Results macro, the search results will show only pages and other content types for which the user has 'View' permission.

Other ways to add this macro

Add this macro using wiki markup

Unable to render {include} The included page could not be found.

Macro name: search

Macro body: None.

Last modified on Oct 6, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.