Property Lens for Confluence: Docs

Getting started

1. Add the Page Properties macro to the pages you want to report on, as you do today, and give those pages a label (for example decision).
2. On the page where you want the report, type /Property Lens and insert Property Lens report. The settings panel opens.
3. Enter the label, choose the spaces, and publish the page.

Choosing pages

• Pages with any of these labels: one or more labels, separated by commas. Pages need at least one of them.
• Spaces: leave empty for this space, enter space keys separated by commas (for example ENG, OPS), or * for all spaces.
• Page Properties ID: if your pages have more than one Page Properties macro, enter the ID to read only that one.
• Extra CQL: an optional CQL condition added to the search, for example ancestor = 12345 AND lastmodified > now("-90d"). Up to 500 characters; ORDER BY is ignored (use the sort setting).
• Most pages to read: the most pages to list, up to 1000 (200 if left empty).

Columns

• Columns to show, in order: the property names to show, separated by commas. Leave empty to show every property found.
• Column widths in percent: for example Title=30, Owner=15, Decision=40.
• Title column: show or hide it, and rename its heading.
• Page status column: show the page status as a lozenge.

Filter, sort and search

• Only pages with these statuses: type status names separated by commas, for example Rough draft, Verified. Use none for pages with no status.
• Sort by: title, status, modified or any column name, ascending or descending. Readers can also click a column heading to sort.
• Rows per page: 5 to 200 (25 if left empty).
• Search box: lets readers filter rows by any text in the table.

What shows in cells

Text, links, mentions, dates and status lozenges keep their look. Images and nested macros inside a value show as text.

Permissions

The report runs as the person viewing the page. They only see pages and values they can open in Confluence. The app stores nothing and makes no calls outside Atlassian.

Limits

• Reports list up to 1000 pages.
• The page status column needs one lookup per page, so large reports with it load slower. Turn it off when you do not need it.
• PDF and Word export of the report is not supported yet.

Need help?

See Support.