Content Reporter

Description

Reports on Confluence content (pages, news, comments, attachments, etc).

The content can be filtered by space, type, scope or labels, as well as any custom filters specified in the body of the macro.

This reporter can be quite slow if your site has a lot of content. Consider using Local Reporter instead where possible.


Parameters

NameRequiredAvailable InDefault ValueDescription

space(s)

 (error)

@self

The comma-separated list of spaces to search in.

Each space may be prefixed by either '+' (to indicate the space is required) or '-' (to indicate the space must be excluded).
May be one of the following:

  • @self - (default) The space the current content is in.
  • @personal - Personal spaces only.
  • @global - Global spaces, that is, non-personal spaces.
  • @favorite - Favourite spaces only.
  • @all - All spaces, both global and personal.
  • SPACE KEY - Any other space key may be specified explicitly.

type(s)

 (error)

all

The comma-separated list of content types to allow.

Each type may be prefixed by either a '+' (to indicate it is require) or '-' (to indicate it must be excluded). May be any of the following: 

  • page
  • news
  • comment
  • attachment
  • spacedescription

label(s)

 (error)


The comma-separated list of label checks. Each type may be prefixed by either a '+' (to indicate it is require) or '-' (to indicate it must be excluded).

e.g.: "one, +two, -three" would list content which has the "two" label but not the "three" label.

scope

 (error)


Comma-separated list of pages, news items, etc which are in scope. If the content is a page, the scope can be expanded to their children, descendants or ancestors: 

  • > children - The direct children of the specified page. e.g.: 'scope=My Page > children'
  • > descendents - All descendants of the specified page. e.g.: 'scope="My Page" > descendents'
  • > ancestors - All ancestors of the specified page. e.g.: 'scope=My Page > ancestors'

This is independent of the space parameter, so if you wish to limit the scope for a page in another space, you will need to put that space key as the prefix, even if you already specified it in the space parameter.

e.g.: "scope=MySpace:My Page > children'.

This parameter might not work properly since v4.1.0. Check our community forums for a workaround.

time

 (error)


Allows the specification of a period of time to search within.

e.g.: 7d will only allow content modified in the last 7 days.

matchAll

 (error)

true

If set to false, content matching any of the criteria will be returned. Otherwise, the content must match all criteria. 


Editor View

Tutorial Examples