VP Swiper Slider - Troubleshooting & FAQ

Common issues, their causes and how to fix them. If your slider isn't behaving the way you expect, scan this page — chances are someone has hit the same problem before. The second half covers frequently asked questions about licensing, support and how the Free and Pro editions relate.

Display issues

Slider shows nothing on the frontend

The module renders, but the slider area is empty or collapsed. Check these in order:

  1. Is the module published? Open the module and check the Status field on the Module tab. Set to Published.
  2. Is the module assigned to the current menu item? Open the Menu Assignment tab. Either choose "On all pages" or explicitly tick the menu item where you're viewing the page.
  3. Does the source have any slides? Switch to the Slide source tab. If it's Custom code, check there's content in the textarea. If it's Image slider, Images or Vendors, check the subform has at least one row. If it's Articles, check the selected category has published articles visible to the current user's access level.
  4. Did you clear the Joomla cache? System → Maintenance → Clear Cache → Clear all. Then hard-reload the page (Ctrl+Shift+R).

Slider renders but looks completely unstyled

Slides appear stacked vertically, with no transitions or arrows. This means the module's CSS isn't loading.

  1. Open the browser console (F12 → Console). Look for 404 errors on vp-swiper.css or similar. If you see them, the asset path is wrong — usually means the module was installed but template overrides interfered. Reinstall the module.
  2. Check that your template loads Bootstrap Icons. Most modern Joomla templates do, but some custom ones don't. Without Bootstrap Icons, navigation arrows and pagination icons render as empty squares.
  3. Clear the Joomla cache and hard-reload.

Arrows or pagination bullets are missing

The slider works but you can't see the navigation arrows on the sides or the bullets below.

  • On the Module tab, check Navigation arrows and Pagination are set to Show.
  • If they're set to Show but still don't appear, the template's CSS may be hiding them. Open browser DevTools (F12), inspect the slider, and look for display: none rules on .swiper-button-prev, .swiper-button-next or .swiper-pagination.
  • For Vendors source specifically, navigation and pagination are often deliberately hidden via the recommended settings — for logo strips, you usually want a clean marquee with no controls.

Images don't load or show broken-image icons

  • Open DevTools → Network and reload. Check if the image requests return 404.
  • If the image was uploaded through Joomla's media manager, the path includes a Joomla-specific suffix like #joomlaImage://.... The module handles this correctly, but the file must actually exist at /images/... on the server.
  • If you migrated the site from another domain, the image paths in saved modules may still point to the old URL. Open each Image slider, Images or Vendors slide in the admin and re-select the images.

Behaviour issues

Autoplay doesn't start

  • Check Autoplay is set to Yes on the Module tab.
  • Check the Autoplay delay (ms) isn't set to 0 or a huge number. Sensible values are 3000-6000.
  • If Stop autoplay on interaction is Yes and you've already clicked an arrow or swiped, autoplay has been disabled for the rest of the page lifetime. Reload to restart.
  • Some browsers throttle background-tab JavaScript. Switch to the tab and check whether autoplay resumes.

Loop doesn't loop — slider stops at the last slide

  • Check Loop is set to Yes on the Module tab.
  • Loop requires enough slides. With fewer slides than Slides per view, Swiper can't loop because there's nothing to wrap. Add more slides or reduce Slides per view.
  • Some transition effects don't support Loop cleanly (Cube needs at least 3 slides; Cards needs 2). See Transition Effects for per-effect requirements.

Articles source doesn't show new articles

You publish a new article in the chosen category, but the slider still shows the old set.

  • Joomla module cache. Open the Advanced tab of the module and set Caching to No Caching. Or wait for the cache to expire (default 15 minutes).
  • The Articles source respects access levels. If the new article is in a registered-only access group and you're viewing as a guest, it won't appear.
  • The new article's publish date matters with sorting. With Descending sort the newest articles appear first; with Ascending, the oldest do.

Responsive breakpoints don't kick in

  • Breakpoints check the viewport width, not the slider container width. Resize the browser window itself, not the column the slider sits in.
  • Make sure your base settings on the Module tab are the narrowest design (typically mobile). Breakpoints override the base for wider screens, not the other way round.
  • Use browser DevTools' responsive design mode (F12 → device toolbar) to test specific widths precisely. Manually dragging the window can miss exact breakpoint boundaries.

Pro-specific issues

Pro features don't seem to work

You enable Zoom, Thumbnails or another Pro option but nothing changes on the frontend. Most common cause: Pro isn't actually installed.

  1. Check System → Manage → Extensions and look for VP Swiper Slider Pro in the list. If only the Free module is there, you need to install Pro on top.
  2. The Pro module is a separate extension — it doesn't replace the Free module. Install it the same way as Free: System → Install → Extensions → Upload Package File.
  3. After installing Pro, edit the module instance and save it once. This refreshes the configuration so Pro options take effect.

Both Free and Pro sliders on the same page conflict

One slider works fine, the other shows wrong effects or fails to initialize.

This shouldn't happen — Free and Pro use separate JavaScript globals (window.VPSwiperFree and window.VPSwiperPro) specifically so they coexist. If you see conflicts, you may have an old cached version of the Pro module's JS. Hard-refresh (Ctrl+Shift+R) and clear the Joomla cache.

Pro effect falls back to Slide

You pick Cube, Coverflow or another Pro effect, but the slider transitions with a plain Slide animation instead.

  • If you're editing a Free module, Pro effects are silently ignored. Convert to the Pro module type by deleting the Free instance and creating a new one with the Pro type.
  • If you're editing a Pro module and still see the fallback, the Pro JS bundle isn't loading. Check the browser console for 404 errors on Pro assets. Reinstall Pro if so.

Update issues

Joomla doesn't see new versions in Find Updates

  • Click Purge Cache on the System → Update → Extensions screen, then click Find Updates again. Joomla caches the update check for a few hours.
  • Verify the module manifest contains the <updateservers> block. Re-install the latest version if it's missing.
  • Confirm your server can reach vpjoomla.com over HTTPS. Some firewalls and shared hosts block outbound HTTPS requests.

Update fails with "checksum mismatch"

The downloaded ZIP doesn't match the SHA-256 hash in the update manifest. This is intentional integrity protection.

Frequently asked questions

What's the difference between Free and Pro?

Free covers three content sources (Custom code, Image slider, Images), two transition effects (Slide, Fade) and the basic slider behaviours (autoplay, loop, navigation, responsive breakpoints). Pro adds two more sources (Articles, Vendors), five more effects (Cube, Coverflow, Flip, Cards, Creative) and eight advanced features (Zoom, Thumbnails, Grid, Parallax, Keyboard, Mousewheel, Hash navigation, History). See the full comparison table on the product page.

Can I install both Free and Pro on the same site?

Yes — they're separate extensions and don't conflict. Each module instance you create is either Free or Pro depending on which type you pick from the module type list. Use this when you want to keep some sliders simple (Free) while others get the Pro treatment.

Do I need to uninstall Free before installing Pro?

No. Pro doesn't replace Free, it's an additional module. Existing Free module instances keep working unchanged; new Pro instances unlock the extra features.

What happens to my sliders if my Pro license expires?

Your existing Pro modules keep working forever — there's no kill switch. What you lose at expiry is access to updates (no new bug fixes, security patches or features) and priority support. Renew to regain both.

Can I use the module on multiple sites with one license?

The standard Pro license is per-site. For agency or multi-site use, see the product page for multi-site options.

Is the module GDPR-compliant?

The module itself doesn't track visitors, set cookies or send data to external services. It runs entirely on your server and in the visitor's browser. If you embed third-party content inside Custom code slides (YouTube iframes, for example), those may have their own privacy implications.

Does it work with my page builder / template framework?

VP Swiper Slider is a standard Joomla module. It works wherever Joomla modules work — module positions, custom HTML modules, page builder widgets that support module rendering. If your page builder lets you place a Joomla module instance, the slider will display correctly.

Can I use Swiper API events from my own code?

Yes. Each slider instance is accessible via window.VPSwiperFree (Free) or window.VPSwiperPro (Pro) as an array of Swiper instances. You can attach event handlers, call methods, and read state from your own scripts. This is for developers — typical usage doesn't need it.

Is Swiper 13 / 14 / future versions on the roadmap?

The module currently runs Swiper 12.1.4, which is the latest stable Swiper at the time of writing. New Swiper releases will be folded into VP Swiper Slider releases as they become available and stable. Major Swiper version upgrades become major VP Swiper Slider version bumps (v3 → v4) since they sometimes change behaviour.

Where do I report bugs or request features?

Still stuck?

If you've worked through this page and still can't get the slider to behave, get in touch. We respond to most support emails within one business day, and for Pro customers within a few hours during the working week. When emailing, please include:

  • Joomla version and PHP version (from System → System Information).
  • VP Swiper Slider version (Free or Pro) and the specific version number.
  • A URL to a page where the issue is visible, if you can share one.
  • A brief description of what you expected vs what actually happens.
  • Any errors from the browser console (F12 → Console).

Email: support@vpjoomla.com

Next steps

You've reached the end of the documentation. Where to next: