Image Carousel

Hero

Macros

Add macro to page

In the Confluence page edit mode, enter “/carousel” and press enter. The macro should be added to the page this way.

Usage

The Image Carousel macro is used to display images on the page. It doesn’t need any configuration, and will automatically display all the images which are attached to a Confluence page.

The carousel is responsive and works with all the different Confluence macro sizes, out of the box.

Configuration

Sorting orderThe Sorting order defines the order in which the displayed images should appear.

Options:
- Ascending (Default)
- Descending
Sorting byDefines which property of the image is used to sort.

Options:

- Upload Date
- Sorts the images according to their attachment upload date
- Label
- Add labels to attachments to sort them accordingly. Labels should be applied in the following schema carousel-{number} (Replace number with the order index)
Example: carousel-0, carousel-1, carousel-2
- Name (Default)
- Sorts the images according to their attachment title
image-20240301-153102.png
BehaviorDefines some additional behavior of the image carousel.

Options:

- Auto Scroll
- If checked, the image carousel will automatically scroll through all the images
Exclude LabelsExclude labels can be used to explicitly exclude a set of images from being displayed.

Define a semicolon (“;”) separated list of labels, which will exclude attachments, containing that label, from being displayed.

Example: carousel-exclude;exclude;no-show

When using this example configuration, every image which has one of the defined labels (carousel-exclude exclude no-show) attached to them, will be excluded.

Examples

horizontal_small.png

horizontal.png

Config small.png

Mixed_without_buttons.png