Search

This 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 Metadata

This 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 Content

This 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.

Parameter	Default	Description	Values
regex2		Regex pattern for matching storage format content. If page content matches regex and other conditions, it will be included

Example

Finding specific content

confluence --action getPageList --space DEMO --regex2 ".*find this exact content on a page.*"

Legacy Search

Legacy 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 Something

If 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

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.

How to find Confluence pages and then do something

On this page