Configuration

The configuration of each macro consists of three sections: Content search, Macro specific, and Gallery item.

Content search

In this section, you will find the configuration options for content search that are the same for every macro.

Query Builder

Utilize our convenient Query Builder to search for the desired content you want to display.

Sources search	Enter a search term that will be used in the ‘Sources’ drop-down to search for sources.
Sources	Select sources for which the gallery content should found. If no source is selected, then the current page will be used as the source. The sources need to be selected from the results of drop-down. The results will only be displayed once a 'Sources search' is provided. The sources search can be performed multiple times. Previously selected sources will be retained until they are deselected.
Properties	When searching for gallery contents based on the selected sources, the following indexed properties of content can be taken into consideration. Ancestor (only with Page Type) - Display all pages where the respective source is an ancestor. Container (only with Attachment Type) - Display all attachments associated with the source. ID - Display the source. Parent (only with Page Type) - Display all pages where the respective source is an parent.
Labels	Provide labels separated by commas to search for. For example: mylabel, otherlabel

Excluding Contents

Configure here which content should be excluded from the search.

Exclude sources search	Enter a search term that will be used in the ‘Exclude sources’ drop-down to search for sources.
Exclude sources	Select sources from which the gallery content should be excluded. The sources need to be selected from the results of drop-down. The results will only be displayed once a 'Exclude sources search term' is provided. The sources search can be performed multiple times. Previously selected sources will be retained until they are deselected.
Exclude properties	When searching for content to be excluded based on the selected sources, the following indexed properties of content can be taken into consideration. Ancestor (only with Page Type) - Display all pages where the respective source is an ancestor. Container (only with Attachment Type) - Display all attachments associated with the source. ID - Display the source. Parent (only with Page Type) - Display all pages where the respective source is an parent.
Exclude labels	Provide labels separated by commas to search for. For example: mylabel, otherlabel

Content Types

Types

Select the content types you wish to display. If no types are checked, it will be akin to searching for all types.

Sorting

Sort

Specify the attribute to sort by. The sort order is ascending unless you select the 'Reverse' sort type.

None (default)

Title - sort by title

Created - sort by created date

Last-modified - sort by last modification date

Sort type

Enable the 'Reverse' option to change the sorting order from ascending to descending.

Custom Search

Custom CQL

Define custom CQL for an advanced search. All fields of Query Builder disregarded for this.

Common

Limit

Number of items per search result.

Media Types

Filter attachments of search result that match the media types selected. If no media type is selected, all attachments will be displayed.

Image (JPEG, PNG, GIF)

PDF

Multimedia (Audio, Video)

ZIP

Currently, the filtering is a workaround solution, as Confluence does not support searching by media types. The number of filtered items may differ from the total found items. We are striving to create a better solution for this.

Macro specific

In this section, you will find the specific configuration options that are displayed based on the macro.

Content Grid

Pagination	Check the 'Paginate' option to navigate through the search result pages.
Size	Define the size of an item. For example: '250px' (for both width and height) or '250px 200px' height (to differentiate between width and height)
Alignment	Define the alignment behavior of items in a row. Left - Align all items in a row to the left. Right - Align all items in a row to the right. Center (default) - Align all items in a row to the center. Space Around - Items in a row will have space before, between, and after them Space Between - Items in a row will have space between them Space Evenly - Items in a row will have equal space around them
Gap	Define the gap between a row and a column. For example: '250px' (for width and height) or 250px 200px (to distinguish between width and height)

Content Slider

Height	Define the height of the slider. For example: '250px'
Items per slide	Specify the number of items per slide.
Gap	Define the gap between slides. For example: '10px'
Navigation	Select the 'Navigate' option to show navigation arrows for moving to the previous or next slide.
Type of pagination	Choose the type of slider pagination. None - Prevent pagination from being displayed. Bullets (default) - Display the current slide position as bullets beneath the slider. Dynamic Bullets - Display the current slide position as bullets with different sizes beneath the slider. Progress - Display the current slide position as a progress indicator at the top edge of the slider.

Gallery item

In this section, you will find the configuration options for gallery item that are the same for every macro.

Link type

Choose the manner in which the items in the gallery should be linked.

None - Items are not being linked.

Container - Attachments link to the content they were attached to. All other content types are directly linked.

Content (default) - All content is directly linked.

Space - All content types are linked to the parent space.

Type of fit

Choose the manner by which the image attachment is placed into the item background.

Contain - The image is scaled to maintain its aspect ratio while fitting within the item background.

Cover - The image is sized to maintain its aspect ratio while filling the entire item background.

Scale-down (default) - The background image is sized as if 'None' or 'Contain' were specified, whichever would result in a smaller concrete object size.