SearchThis search is based on Confluence's search index and is the fastest way to search for simple text similar to goggle searching. It is roughly the same as the search available on the UI for finding text strings. This is the recommended technique for most searches and is supported on getPageList, runFromPageList, getContentList, and runFromContentList. | Parameter | Default | Description | Values |
|---|
| cql |
| The most powerful search available from Confluence - see Advanced Searching With CQL | valid cql statement |
Find Pages Via MetadataThis means using things like title, page hierarchy, labels, and similar. Use getPageList and runFromPageList actions. | Parameter | Default | Description | Values |
|---|
| space | All spaces | Restrict to a single space if specified. Required unless labels is not blank. | space key, @all | | labels | All pages | Restrict to pages with at least one label. | comma separated list of labels | | title | All pages | Subset to related pages based on other parameters |
| | ancestors | off | Set to add all ancestors of the page identified by the title parameter | Set using --ancestors | | descendents | off | Set to add all descendents of the page identified by the title parameter | Set using --descendents | | children | off | Set to add all (direct) children of the page identified by the title parameter | Set using --children | | regex |
| Regex pattern for matching titles. If title matches regex and other conditions, it will be included |
|
Search ContentThis means actual source (storage format) content of the page which is different than normal index based search normally done on content using CQL. Normally only used for finding text in source that normally would not be in the search index.This is the most accurate way to find specific content on pages, but it is very resource intensive as it must retrieve page source from the server to do the regex pattern matching. This can take minutes to hours depending on the number of pages that need to be searched. Use with caution. If performance is a major issue, there is another, more advanced approach - see How to use SQL to find pages. | | | |
|---|
regex2 |
| Regex pattern for matching storage format content. If page content matches regex and other conditions, it will be included |
|
ExampleFinding specific content | No Format |
|---|
confluence --action getPageList --space DEMO --regex2 ".*find this exact content on a page.*"
|
Legacy SearchLegacy search parameters like search, searchModified, searchTypes, and related have been deprecated for some time and have been removed for version 7.0 in favor of Confluence CQL which is significantly more powerful. See Version 7.0 - Removed Actions and Parameters for more details. Doing SomethingIf you need to act on the pages found, the easiest way is to use runFromPageList or runFromContentList to automatically run an action or script of actions for each page found. Things like modifyPage or removePage. Example| No Format |
|---|
confluence --action runFromPage --space DEMO --regex2 ".*find this exact content on a page.*" --common "--action removePage --id @pageId@" |
For more examples, go to How to Globally Search and Modify Content.
|