Documentation – Macro Features

Inserting the Macro

The macro can be inserted like any other Confluence macro:

  1. Open the page in edit mode.

  2. Type / (slash command) and search for “better-confluence-list” the macro name.

  3. Select the macro and insert it into the page.

  4. Once inserted, the configuration dialog opens with three tabs: Search, Table, and CQL.

Settings – Tab Search

In the Search tab, you can define the search parameters that determine which content is displayed by the macro.

Search Field

  • A text field where you can enter the search keyword.

  • The search runs across all selected content types.

Type Filter

  • A list of checkboxes where you can choose which content types should be searched.

  • Supported types:

    • Posts

    • Pages

    • Attachments

    • Comments

    • Folders

    • Whiteboards

    • Databases

    • Spaces

Multiple selections are possible.

Limit

  • Defines the maximum number of search results.

  • Default value: 10.

Username Filter

  • A text field to restrict results to content created by a specific user.

  • Example: entering Anna Admin will only show results authored by this user.

Time Range

  • You can specify From and To dates.

  • Only content created within this range will be included in the results.

  • If no dates are provided, all results are considered.

Settings – Tab Table

In the Table tab, you can configure how the search results are displayed in the table and how they are sorted by default.

Select Columns to Display

  • Choose which columns should be visible in the results table.

  • Available options:

    • Type

    • Title

    • Space

    • Description

    • Owned by

    • Updated at

You can select multiple columns.

Default Sort Column

  • Defines the column that will be used for sorting the results initially.

  • Available options are the same as for the columns above:

    • Type

    • Title

    • Space

    • Description

    • Owned by

    • Updated at

Default Sort Order

  • Defines the direction of the default sorting.

  • Options:

    • Ascending (asc)

    • Descending (desc)

Rows per Page

  • Sets how many results are shown per page in the table.

Settings – Tab CQL

The CQL tab allows you to use a custom Confluence Query Language (CQL) query instead of the predefined search settings.

Enable CQL

  • A checkbox to activate CQL mode.

  • Important: If CQL is enabled, all settings from the Search tab are ignored.

Custom CQL Query

  • A text field where you can enter your own CQL expression.

  • This allows advanced filtering and searching beyond the standard search configuration.

Interactive Resorting

  • Once the results are displayed, users can resort the table at any time by clicking on the column headers.