In this page

What is a Content list?

A Content list allows you to browse a list of contents (pages, blog posts), with the ability to sort and export the list, and to view important metadata. It is available in multiple contexts across the app, such as on dedicated dashboards, in popups, and in macros, providing the same convenience features.

Scopes

The Content list dashboard is available for the whole Confluence site and for any single space. As a generic content browsing interface, it is also available as macros and in content list popups.

Content list report for the site

For the site scope report, expand the Apps section in the left-bar (not Space apps!) → click the Better Content Archiving app → Content list tab. In this scope, the report covers all spaces, all contents and all activities on the site.

The report displays all contents on the site, regardless of their space.

Content list report for a space

For the space scope report, go to the space → expand the Space apps section in the left-bar (not Apps!) → click the Better Content Archiving app → Content list tab. In this scope, the report covers only that single space, the contents and the activities in it.

The report displays only the contents in the space.

Content list as a macro

The Content list is also available as a macro that you can insert into any page. It will display the contents returned by any configured CQL query.

For more information, see the Content Status List macro documentation.

Content list in popups

When you click on various numeric content statistics throughout dashboards, a fully featured Content list popup will appear.

It will display the contents matching the context of the statistic you clicked on — e.g. contents in a specific space and status, or having specific ownership.

Understand the Content List

A Content list displays a set of contents (pages, blog posts) based on the context: either all contents on the site, contents in a specific space or contents matched by a custom CQL query.

The following columns can be displayed, depending on the configuration:

  • Space: Enclosing space of the content, with a link to the space itself. (For macros, you can also configure whether to open the link in a new tab or not.)
  • Title: Title of the content, with a link to the content itself. (For macros, you can also configure whether to open the link in a new tab or not.)
  • Version: Version number of the content.
  • Content status: Status assigned by the app, as defined by the enclosing space's content status scheme.
  • Owners: Zero or more content owners (managed by the app).
  • Limited owner: Content owner (managed by Confluence).
  • Expiration date: Expiration date of the content, if set.
  • Archiving date: Archiving date of the content, if set.
  • Last update: Last update date and updating user.
  • Last view: Last view date and viewing user.

Work with the Content List

The content list is paginated. You can navigate through the pages using the pagination controls at the bottom of the list.

Some columns can be sorted in either ascending or descending order by clicking on the column header. (Availability of this feature depends on whether CQL actually supports sorting by the corresponding field or not.)

Configure columns

Below the content list, you will find the Settings (indicated by a cog icon), which allows you to configure:

  • the columns to be displayed
  • the page size (how many contents to display on one page)

Configuration is saved per user, per screen, so each user can configure the report as they prefer, per context.

Use quick actions

Quick actions can also be accessed from the cells of certain columns, allowing you to change content status and other fields without leaving the list. The following cells support quick actions:

  • Content status
  • Owners
  • Limited owner
  • Expiration date
  • Archiving date
  • Last update
  • Last view

Note that some changes take time to be reflected in the list.

Export contents to CSV

You can use the Download CSV button to export the list of contents as a CSV file, which you can open in Excel or any other spreadsheet software.

The export will contain the currently displayed columns and rows (the latter for scalability reasons), also keeping the actual sorting of rows. One column on the user interface may explode to multiple columns in the CSV for easier processing, as shown in the table below.

Column in the content list Columns in the CSV file
Space Space URL
Space ID
Space key
Space name
Title Content URL
Content ID
Content type
Content title
Version Version
Content status Content status
Owners Owner IDs (comma separated list of Atlassian user IDs)
Owners (comma separated list of names)
Limited owner Limited owner ID (Atlassian user ID)
Limited owner (name)
Expiration date Expiration date (in "YYYY-MM-DD HH:mm" format)
Archiving date Archiving date (in "YYYY-MM-DD HH:mm" format)
Last updated Last updater ID (Atlassian user ID)
Last updater (name)
Last updated (in "YYYY-MM-DD HH:mm" format)
Last viewed Last viewer ID (Atlassian user ID)
Last viewer (name)
Last viewed (in "YYYY-MM-DD HH:mm" format)

Security

The Content list is available for all users. It respects the Confluence space permissions and page restrictions.

As the list is personalized for the user who opens it, your view and your teammate's may be different.

Questions?

Ask us any time.