Contents7 sections
The carousel on your homepage shows its first slide and then just sits there. A carousel, also called a slider, is a box that shows several images or messages one after another. When a WordPress slider is not working like this, the cause is usually a setting, not a broken plugin.
These checks work for most WordPress carousels, whether yours comes from your theme, a slider plugin or a page builder. Do them in order. The first ones take a minute.
Check 1: Is it set to move on its own?
Many carousels only move when a visitor clicks an arrow or a dot. Moving by itself is a separate setting, usually called Autoplay, Auto-rotate or Slideshow.
- Find where your carousel is set up. For a slider plugin, look for its name in the dashboard’s left-hand menu. For a theme carousel, look under Appearance or in the theme’s own settings. In the block editor, click the carousel block and look in the settings panel on the right.
- Turn on Autoplay or its equivalent.
- Check the delay between slides. It is often in milliseconds, where 5000 means 5 seconds. A very large number can look like no movement at all.
- Save, then reload your homepage.
Watch out for pause on hover. Most carousels pause while the mouse pointer rests over them, so people can read. If your pointer is on the slide while you watch, it will never move. Move the pointer away and wait.
Check 2: Is there more than one slide?
A carousel with one slide has nothing to move to. Slides can also be hidden without you noticing.
- Open the carousel’s slide list and count the slides.
- Check that each slide is published and switched on. A slide saved as a draft, or set to start on a future date, does not show.
- Check for device settings such as Hide on mobile. A carousel with three slides on a computer may have only one on a phone.
Check 3: Your device may be asking for less motion
This is the check most people miss. Computers and phones have an accessibility setting that asks websites to keep movement to a minimum. It helps people for whom moving content causes dizziness, nausea or difficulty reading. Websites can detect this setting, and well-built carousels respect it by not moving on their own. The arrows still work.
Example. The carousel moves on your colleague’s laptop but not on yours. Your laptop has reduced motion turned on, so the carousel is doing exactly what it should.
To find out, test on a second device, or check the setting on yours:
- Windows 11: Settings › Accessibility › Visual effects. If Animation effects is off, reduced motion is on.
- Windows 10: Settings › Ease of Access › Display. Look at Show animations in Windows.
- macOS Tahoe (26) and later: Apple menu › System Settings › Accessibility › Motion › Reduce motion.
- macOS Sequoia (15) and earlier: Apple menu › System Settings › Accessibility › Display › Reduce motion.
- iPhone and iPad: Settings › Accessibility › Motion › Reduce Motion.
- Android: Settings › Accessibility › Color and motion › Remove animations. Some phones place it under Text and display instead.
If the setting is on, please do not try to force the carousel to move anyway. The visitors who switch this on need it. Accessibility guidelines also ask that anything moving by itself for more than five seconds has a way to pause or stop it, so make sure your carousel shows a pause button or arrows.
Check 4: A cache or JavaScript optimisation is getting in the way
Carousels are driven by JavaScript, the code that makes things move and react in the browser. Optimisation plugins and some hosts change how JavaScript loads so pages appear faster. Two common changes can stop a carousel:
- Delaying JavaScript until the visitor scrolls, taps or moves the mouse. The carousel then sits still at first.
- Combining or minifying JavaScript, which merges and shrinks files. If it puts them in the wrong order, the carousel’s code fails.
A cache, a stored copy of your pages, can also keep serving an old, broken version after you have fixed something.
- Clear your caches. Look in the black toolbar at the top of the dashboard for a button such as Clear cache or Purge all, and clear any cache in your hosting dashboard.
- Open your homepage in a private window, which ignores your browser’s stored copy, and wait ten seconds. In Chrome this is New Incognito window, in Firefox New private window and in Safari File › New Private Window.
- If it still does not move, open your optimisation plugin’s settings. Turn off options with names like Delay JavaScript, Defer JavaScript or Combine JavaScript files, one at a time.
- After each change, clear the cache and test again in a private window.
- When the carousel moves, you have found the option. Many optimisation plugins let you exclude a single script, so you can keep the option on for everything else. Their documentation explains how.
Our tutorial Speed Up WordPress: 8 Checks That Actually Move the Needle explains these speed settings and when they are worth it.
Check 5: Look for JavaScript errors
If JavaScript hits an error, it often stops running, and everything after the error, including your carousel, stays still. Your browser lists these errors in the JavaScript console, a panel for messages from the page. You only need to read it, not change anything.
- Open your homepage in Chrome, Edge or Firefox on a computer.
- Open the console. In Chrome or Edge press Ctrl+Shift+J on Windows, or Command+Option+J on a Mac. In Firefox press Ctrl+Shift+K, or Command+Option+K on a Mac.
- In Safari, first choose Safari › Settings › Advanced and tick Show features for web developers. Then choose Develop › Show JavaScript Console, or press Option+Command+C.
- Reload the page with the console open. Look for lines in red.
Example. You see this red line:
Uncaught ReferenceError: jQuery is not defined
Safari words the same problem as Can’t find variable: jQuery. jQuery is a helper library many carousels use. This error means the carousel tried to run before jQuery had loaded, which is very often caused by the delay or combine options in check 4. On the right of the red line, the console shows which file the error came from. If the file’s address contains /wp-content/plugins/ followed by a name, that name tells you which plugin to look at.
Copy the red line exactly as shown. Whoever helps you next will want it.
Check 6: Two pieces of software are clashing
Sometimes two plugins, or a plugin and your theme, load competing slider code. To test, switch off other plugins temporarily. On a shop or a busy site, do this on a test copy, often called a staging site, which many hosts provide.
- Make a backup of your site.
- Go to Plugins › Installed Plugins.
- Deactivate every plugin except the one that provides the carousel. Deactivating switches a plugin off without deleting it.
- Test the homepage in a private window. If the carousel now moves, reactivate the other plugins one at a time, testing after each.
- When it stops again, the plugin you just switched on is the clash. Leave it off and tell both plugin authors what you found.
Finally, check that WordPress, your theme and your plugins are up to date under Dashboard › Updates. Slider bugs are often fixed in updates.
Still not moving?
Note down which checks you have done and any red console lines, then contact the carousel’s author. If the carousel comes from a Locker Forge theme or plugin, Contact support and include those notes. More fixes like this one are in Solutions.