| 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 |
