Search macro

Add a search bar that allows users to search globally or in a specific space.

Add and edit the macro

You can add macros to pages, user dashboards, and space layouts.

To change its settings, click the macro > Edit.

Parameter	Description	Available since

Parameter	Description	Available since
Placeholder text	Add a custom placeholder text to the search bar, for example Search the wiki.	6.0
Space key	Specify a space key to limit the search to that specific space.	4.0
Category	Specify a category key to limit the search to that specific category.	6.0
Site	Specify a site to limit the search to that specific site.	6.0
CQL	Note: This is an advanced option using Atlassian CQL. Defining a query here will ignore other filtering parameters. The default search query is: `(title ~"$query" or label in ("$query"))`	6.0

Macro keys are used to identify macros in the macro browser and to build custom solutions. The Search macro key is rw-search.