Plugin Directory

Portfolio Slideshow

Add a clean, responsive JavaScript slideshow to your site.

Q: How do I insert a slideshow into a post or page?

A: Upload your photos to the post or page using the "Add Slides" metabox. You can drag-n-drop images into the uploader that pops up, add captions and descriptions to these images, etc.

Then, simply add the shortcode [portfolio_slideshow] where you want the slideshow to appear in the page, and publish the post. Nice!

One common mistake is to insert the images into the post using the content editor. This is not necessary – the plugin detects all images attached to the post and creates the slideshow automatically.

Q: Does the plugin support images that are not uploaded via the media uploader?

A: No, the plugin does not support random folders of images or images on a third-party site at this time.

Q: Why isn't my slideshow loading?

A: If the images show up fine in the "Add Slides" metabox in your admin, but don't on the front-end, this could be a theme conflict. Your best option is to inspect the page with a browser console open, and/or to set WP_DEBUG to true in your site's wp-config.php file to see if any PHP errors show up on your site.

If you can see the first slide of the slideshow, but clicking doesn't do anything, this is almost always a JavaScript conflict from your theme (or another plugin). It could caused by a jQuery library conflict. View the HTML source of the page which is supposed to show the slideshow. Do you see more than one copy of jQuery or the Cycle plugin being loaded? If your theme or other plugins load those same files directly, you will have a conflict. Your best option here is to manually dequeue conflicting scripts. Check out the wp_dequeue_script() function for more information on doing so.

Q: I haven't found multiple versions of a conflicting file. In fact, I can't see jQuery Cycle or Portfolio Slideshow's CSS loading at all! What gives?

If you don't see the jQuery Cycle plugin or Portfoliio Slideshow JavaScript and CSS files being loaded on posts and pages with the [portfolio_slideshow], then 99 times out of 100 this means that your theme is not using the required WordPress theme functions wp_head() and/or wp_footer(). These functions are required for almost all plugins to work correctly, not just Portfolio Slideshow. Consider the lobster. Then consider using a different theme.

Q: How do I change the size of the images?

A: By default, the slideshow uses the large-size images that are generated by WordPress when you upload an image. You can change this default in the settings panel for the plugin, or on a per-page basis using the size attribute (see installation instructions for usage).

If you would like to change the size of the images system-wide (for example, you want a large image to be 800px instead of 1025px) you can change the WordPress settings in the "Settings -> Media" control panel. You will need to regenerate your thumbnails to make the setting retroactive. If you're in this situation, I cannot recommend the aptly named Regenerate Thumbnails plugin enough! Download it here. I have used that on sites with thousands and thousands of large images, and it works wonders.

Requires: 4.1 or higher
Compatible up to: 4.2.4
Last Updated: 2015-8-9
Active Installs: 30,000+


4.4 out of 5 stars


2 of 34 support threads in the last two months have been resolved.

Got something to say? Need help?


Broken :(

0 people say it works.
10 people say it's broken.

100,1,1 100,2,2 100,2,2 100,2,2 100,2,2 100,1,1 100,1,1
100,1,1 67,3,2 100,1,1 0,2,0 100,1,1 100,3,3
100,5,5 100,5,5 100,6,6 100,1,1 100,3,3 0,2,0 100,1,1 100,1,1 100,1,1 100,1,1 100,3,3 100,1,1 100,1,1
100,1,1 100,1,1
0,1,0 100,1,1 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1
100,2,2 100,1,1 75,4,3 100,2,2 100,4,4 80,5,4 92,13,12 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,2,2 100,1,1 100,4,4 100,1,1
100,2,2 100,4,4 50,2,1 100,7,7 100,1,1 100,1,1 100,1,1
100,2,2 40,15,6 100,1,1
100,1,1 100,1,1
100,2,2 100,4,4 100,1,1
100,2,2 79,28,22 100,5,5 100,3,3 78,9,7 100,1,1 100,4,4 100,1,1
67,3,2 100,2,2 100,1,1
88,8,7 77,26,20 100,9,9
88,8,7 100,7,7 50,2,1
0,3,0 67,3,2 85,13,11 100,3,3
67,6,4 100,1,1
100,1,1 67,3,2 100,5,5
20,10,2 0,6,0