A complete reference for every option in VP Swiper Slider. Use this page when you know what you're looking for and need a quick definition — every field on every tab is here, with its default value, type and a one-line description. For tutorials and use cases, see the other articles in the documentation.
How to use this page Use your browser's Ctrl+F (or Cmd+F on Mac) to search by field name. Options are grouped by the tab they live on, then listed in the order they appear in the admin.
Module tab
The main tab. Contains all slider behaviour options, including effect-specific parameters and Pro features. Scroll past the standard Joomla settings (Title, Position, Status, etc.) to reach these.
| Option |
Type |
Default |
Description |
| Navigation arrows |
Switch |
Show |
Previous/next arrow buttons on the sides of the slider. |
| Pagination |
Switch |
Show |
Pagination indicators below the slider. |
| Pagination type |
Dropdown |
Bullets |
Visible when Pagination is Show. Options: Bullets, Fraction (e.g. "3 / 7"), Progressbar (Pro only). Other types may also be present. |
Layout
| Option |
Type |
Default |
Description |
| Space between slides (px) |
Number |
20 |
Pixel gap between adjacent slides. |
| Slides per view |
Number |
3 |
How many slides are visible at once. Most effects support only 1; only Slide and Coverflow handle multiples cleanly. |
| Transition speed (ms) |
Number |
300 |
Duration of each slide transition in milliseconds. 200-400 feels natural; 600+ starts to feel sluggish. |
Behaviour
| Option |
Type |
Default |
Description |
| Loop |
Switch |
No |
When the last slide is reached, continue back to the first instead of stopping. |
| Loop prevents sliding |
Switch |
No |
Visible when Loop is Yes. Blocks the user from swiping while a loop transition is in progress. |
| Grab cursor |
Switch |
Yes |
Show the "grab" hand cursor when the visitor hovers over the slider, signalling that it can be dragged. |
| Auto height |
Switch |
No |
Slider container resizes to match the active slide's height. Useful when slides have very different heights. |
| Rewind |
Switch |
No |
When the user reaches the last slide and swipes forward, jump back to the first instead of stopping. Different from Loop — there's no continuous looping, just a single rewind. |
| RTL mode |
Switch |
No |
Reverse the slider direction for right-to-left languages (Arabic, Hebrew). |
Autoplay
| Option |
Type |
Default |
Description |
| Autoplay |
Switch |
Yes |
Automatically advance slides on a timer. |
| Autoplay delay (ms) |
Number |
5000 |
Visible when Autoplay is Yes. Time between automatic transitions in milliseconds. |
| Stop autoplay on interaction |
Switch |
No |
Visible when Autoplay is Yes. Permanently stop autoplay when the user interacts with the slider (clicks an arrow, swipes, etc.). |
| Pause autoplay on hover |
Switch |
No |
Visible when Autoplay is Yes. Pause autoplay while the cursor is over the slider, resume when it leaves. |
Transition effect
| Option |
Type |
Default |
Description |
| Transition effect |
Dropdown |
Slide |
The animation between slides. See Transition Effects for all seven options. |
Cube parameters
Visible only when Transition effect is Cube. All four parameters control the cube's drop shadow and slide shading.
| Option |
Type |
Default |
Description |
| Cube shadow |
Switch |
Yes |
Ground-shadow under the cube. Adds depth. |
| Cube slide shadows |
Switch |
Yes |
Shading on the non-active faces of the cube. |
| Cube shadow offset |
Number |
20 |
Distance of the ground shadow from the cube in pixels. |
| Cube shadow scale |
Number |
0.94 |
How wide the ground shadow spreads relative to the cube. Decimal, 0-1. |
Coverflow parameters
Visible only when Transition effect is Coverflow.
| Option |
Type |
Default |
Description |
| Coverflow rotate |
Number |
50 |
Tilt angle of side slides in degrees. |
| Coverflow stretch |
Number |
0 |
How close side slides sit to the centre in pixels. Increase to overlap them. |
| Coverflow depth |
Number |
100 |
How far back side slides recede in pixels. |
| Coverflow modifier |
Number |
1 |
Multiplier applied to all Coverflow parameters above. |
| Coverflow slide shadows |
Switch |
Yes |
Shading on tilted slides for extra depth. |
Pro featuresPRO
All Pro options are visible in Free but ignored at render time. Install Pro to make them work.
| Option |
Type |
Default |
Description |
| Grid layout (Pro) |
Switch |
No |
Render slides in multiple rows. See Grid layout. |
| Grid rows |
Number |
2 |
Visible when Grid layout is Yes. Number of rows. |
| Keyboard control (Pro) |
Switch |
No |
Navigate slides with the keyboard's arrow keys. |
| Mousewheel control (Pro) |
Switch |
No |
Advance the slider when the user scrolls the mouse wheel over it. |
| Zoom (Pro) |
Switch |
No |
Allow double-click or pinch to zoom into slide images. |
| Parallax (Pro) |
Switch |
No |
Move slide elements at different speeds for a 3D feel. |
| Thumbnail navigation (Pro) |
Switch |
No |
Show a thumbnail strip below the slider for jumping between slides. |
| Thumbnails per view |
Number |
5 |
Visible when Thumbnail navigation is Yes. How many thumbnails to show at once (2-12). |
| Thumbnail height (px) |
Number |
80 |
Visible when Thumbnail navigation is Yes. Height of each thumbnail in pixels (40-200). |
| Slide on thumbnail click |
Switch |
Yes |
Visible when Thumbnail navigation is Yes. Whether clicking a thumbnail jumps the main slider to that slide. |
| Hash navigation (Pro) |
Switch |
No |
Reflect the active slide in the URL hash. |
| History (Pro) |
Switch |
No |
Push each slide change into browser history. |
Slide source tab
Pick the content source and configure the slides themselves. The visible fields depend on which source you select.
| Option |
Type |
Default |
Description |
| Content source |
Dropdown |
Custom code |
Which content source the slider pulls from. See Content Sources Overview. |
Custom code source
| Option |
Type |
Default |
Description |
| Custom HTML |
Textarea |
— |
Raw HTML. Each slide must be wrapped in <div class="swiper-slide">...</div>. |
Image slider source
Subform — repeat the four fields below for each slide.
| Option |
Type |
Default |
Description |
| Image |
Media |
— |
Background image for the slide. |
| Title |
Text |
— |
Heading overlaid on the image. |
| Text |
Text |
— |
Supporting line under the title. |
| Button label |
Text |
— |
Text on the call-to-action button. Leave empty to hide the button. |
| Button link |
URL |
— |
Where the button goes. Required when Button label is set. |
Images source
Subform — repeat the four fields below for each slide.
| Option |
Type |
Default |
Description |
| Image |
Media |
— |
The picture itself. |
| Link |
URL |
— |
Optional — makes the whole slide a clickable card. |
| Title |
Text |
— |
Optional caption heading, shown below the image. |
| Text |
Textarea |
— |
Optional supporting line, shown below the title. |
Vendors sourcePRO
Two fixed dimension fields plus a subform — repeat the subform fields for each logo.
| Option |
Type |
Default |
Description |
| Vendor image width |
Number |
— |
Default pixel width applied to every logo. Override per-logo via the subform. |
| Vendor image height |
Number |
— |
Default pixel height applied to every logo. |
| Image |
Media |
— |
Per-logo. The logo file. |
| Alt |
Text |
— |
Per-logo. Accessibility text for the logo. |
| Width |
Number |
— |
Per-logo. Override the default width for this logo only. |
| Height |
Number |
— |
Per-logo. Override the default height for this logo only. |
Articles sourcePRO
| Option |
Type |
Default |
Description |
| Category |
Multi-select |
— |
One or more Joomla content categories to pull articles from. |
| Number of articles |
Number |
3 |
How many articles to fetch. |
| Sorting |
Dropdown |
Descending |
Ascending or Descending by article publish date. |
| Show intro image |
Switch |
Show |
Toggle the article's intro image on each card. |
| Show title |
Switch |
Show |
Toggle the article title. |
| Show intro text |
Switch |
Show |
Toggle the article intro text (line-clamped for equal card heights). |
| Show read more |
Switch |
Hide |
Toggle the "Read more" link at the bottom of each card. |
Slider breakpoints tab
Single subform with three fields per row. Add as many rows as breakpoints you need. Mobile-first — each row's settings apply from the given width upwards. See Responsive Breakpoints for details.
| Option |
Type |
Default |
Description |
| Screen size (px) |
Number |
— |
Minimum viewport width at which this breakpoint applies. |
| Slides per view |
Number |
— |
Number of visible slides from this width upwards. |
| Space between (px) |
Number |
— |
Spacing between slides from this width upwards. |
Advanced tab
Standard Joomla module options — these aren't specific to VP Swiper Slider. Documented here for completeness.
| Option |
Type |
Default |
Description |
| Module Class Suffix |
Textarea |
— |
Custom CSS class added to the module wrapper. Useful for per-instance styling. |
| Caching |
Dropdown |
Use Global |
Whether to cache this module's output. Options: Use Global (follow site setting), No Caching. |
| Cache Time |
Number |
900 |
Cache duration in seconds when caching is enabled. |
Note For sliders using the Articles source, consider setting Caching to No Caching. With caching on, newly published articles only appear in the slider when the cache expires (default 15 minutes). For static sliders — image carousels, logo strips — leave caching on for better performance.
Next steps