Confluence Search Syntax
This page describes the special words and punctuation marks you can use to refine your search.
Matched phrase search
Use double quotes to search for content that contains the phrase 'cheese one', or a phrase where 'cheese' and 'one' are the major words:
Note: Confluence will ignore common words (stop words), including 'and', 'the', 'or', and more, even if they are included within double quotes. See the default list of stop words used by Confluence's search engine, Lucene, in the Lucene documentation.
- Searching for "cheese one" returns only pages in which 'one' appears as the first word after 'cheese'.
- Searching for "the one" returns all pages containing 'one' because 'the' is a stop word.
If you'd like to override Lucene's tokenisation and stemming, cast your vote on this improvement request: CONF-14910 - Provide ability to override Lucene tokenisation and stemming and search for exact text Open
To search for content that contains one of the terms, 'chalk' or 'cheese', use the operator OR in capital letters:
To search for content that contains both the terms 'chalk' and 'cheese', use the operator AND in capital letters:
To search for content that contains 'chalk' but NOT 'cheese', use the operator NOT in capital letters:
Excluded term search
To search for content that contains 'chalk' and 'butter' but not 'cheese':
Group search terms
To search for content that must contain 'chalk' but can contain either 'cheese' or 'butter', use brackets to group the search terms:
To search for content with 'chalk' in its title, where 'title' is the field keyword.
Date range search
To search for content created or modified within a certain date range, using the created or modified keywords. The date stamps are in numeric 'yyyymmdd' format:
You can use one or more wildcard characters in your search and place them anywhere in the search string, except at the very beginning. So, you could search for
http*.atlassian.*, but you can't search for
?ttps://confluence.atlassian.*, as they begin with a wildcard.
Wildcards can either replace a single character in your search, or multiple characters.
To replace a single character in your search, use a question mark (?) as a wildcard, For example, to search for 'butter', 'bitter', 'better', or 'batter'.
To replace multiple characters in your search, use an asterisk (*) as a wildcard. For example, to search for 'chicken' or 'chickpea':
Use multiple wildcards in your search. The following query will search find 'chick', 'coconut', or 'chickpea':
You can also combine wildcard characters in one search. For example, the search term below will return 'chick' but not 'chickpea':
Note: Confluence doesn't support leading wildcards. This means searching for
*heese will not return cheese.
Use a tilde character followed by a number, to find two words within a certain number of words of each other.
For example, the following search will return 'Octagon blog post', but not 'Octagon team blog post':
The following search isn't valid, because you can't search for two words within zero words of each other. If you think the words are next to each other, use the matched phrase search.
Use the operator 'TO', in capital letters, to search for names that fall alphabetically within a specified range:
Note: You can't use the AND keyword inside this statement.
Use a tilde (~) character to find words spelled similarly.
If you want to search for octagon, but you're not sure how it's been spelt, type the word followed by a tilde:
You can also combine various search terms together:
Searching for macros
You can search Confluence content to find where a macro is used. Start your search string with
macroName: and type the macro name after the colon. For example, to search for all excerpt-include macros:
For more information about
macroName and other search fields, see Confluence Search Fields.
Searching for labels
Use the '
labelText:' prefix to search specifically for content that has a specific label. The table below gives examples of search terms that you can enter into Confluence's search box, and the search results that you can expect.
Searching for ...
Returns content that ...
contains the word '
contains the word '
has the label '
has both labels '
labelText:' prefix is an example of a search field. See more about Confluence Search Fields.
Was this helpful?
Thanks for your feedback!