Menu Close

Carousel

 

Option name Possible values Default value
source
This option defines which images will be shown in the gallery. Images can be selected manually from media library or fetched automatically from post featured images, or even filtered by a taxonomy.
media: 1,2,3 (Media file IDs)
posts: 1,2,3 (Post IDs)
posts: recent (Recent posts)
taxonomy: book/3,5 (Taxonomy term slug / term IDs)
none
limit
Maximum number of posts to search featured images in (for recent media, recent posts, and taxonomy)
Number from -1 to 100 20
slides_style
This option control carousel slides appearance.
default (Default)
minimal (Minimal)
photo (Photo)
default
controls_style
This option control carousel controls appearance.
dark (Dark)
light (Light)
dark
crop
This option allows to enable/disable image cropping and crop aspect ratio.
none (Do not crop images)
21:9 ([Landscape] 21:9)
16:9 ([Landscape] 16:9)
16:10 ([Landscape] 16:10)
5:4 ([Landscape] 5:4)
4:3 ([Landscape] 4:3)
3:2 ([Landscape] 3:2)
2:1 ([Landscape] 2:1)
1:1 ([Square] 1:1)
1:2 ([Portrait] 1:2)
2:3 ([Portrait] 2:3)
3:4 ([Portrait] 3:4)
4:5 ([Portrait] 4:5)
10:16 ([Portrait] 10:16)
9:16 ([Portrait] 9:16)
9:21 ([Portrait] 9:21)
4:3
columns
This option control the number of columns used in the carousel.
Number from 1 to 8 1
adaptive
Set this option to Yes to ignore the columns parameter and display a single column on mobile devices.
yes or no yes
spacing
Adds spacing between carousel columns.
yes or no yes
align
This option controls how the gallery will be aligned within a page. Left, Right, and Center options require Max Width to be set. Full option requires page template with no sidebar.
none (None)
left (Left)
right (Right)
center (Centre)
full (Full)
none
max_width
Sets maximum width of the carousel container. CSS uints are allowed.
Example values: 500, 500px, 50%, 40rem.
Default value: none.
Any text value none
captions
Set this option to Yes to display image captions.
yes or no no
arrows
This option enables left/right arrow navigation.
yes or no yes
dots
This option enables dots/pages navigation.
yes or no yes
link
This option adds links to carousel slides.
none (None)
image (Full-size image)
lightbox (Lightbox)
custom (Custom link (added in media editor))
attachment (Attachment page)
post (Post permalink)
none
target
This option controls how slide links will be opened.
self (Open in same tab)
blank (Open in new tab)
blank
autoplay
Sets the time interval between automatic slide transitions, in seconds. Set to 0 to disable autoplay.
Number from 0 to 15 5
speed
This option control slides transition speed.
immediate (Immediate)
fast (Fast)
medium (Medium)
slow (Slow)
medium
image_size
This option controls the size of carousel slide images. This option only affects image quality, not the actual slide size.
full (Original image size)
thumbnail (Thumbnail)
medium (Medium)
medium_large (Medium_large)
large (Large)
large
outline
This option enables outline when carousel gets focus. The outline improves keyboard navigation.
yes or no yes
class
Additional CSS class name(s) separated by space(s)
CSS class name(s) separated by space(s)

none