Portfolio Slideshow


Simple, Responsive Slideshows In Seconds

Portfolio Slideshow adds a simple slideshow builder to posts and pages on your site. Its drag-and-drop interface lets you upload, reorder, edit, delete, or add more images “on the fly” right on the page; it makes it almost fun just to play around with.

Once you’ve arranged your images as you see fit, simply drop the [portfolio_slideshow] shortcode anywhere in that post or page, and voila – an elegant, customizable, responsive slideshow will appear on your site.

Clean and Intuitive UI

Nobody likes a cluttered admin, or gaudily-designed plugins. Portfolio Slideshow blends seamlessly into the default design of the WordPress admin. You might forget that you’re using a plugin in the first place, and not something built into WordPress by default!


  • Example gallery.

  • Use the "Upload and Manage Images" button to add, sort, and delete your photos.

  • Insert the slideshow by using this shortcode, exactly as shown. Do not insert the photos into the post.

  • Settings control panel.

  • Finding the attachment ID for your images.

  • Adding an external URL to a slide.


Install & Activate

Installing the plugin is easy. Just follow these steps:

  1. From the dashboard of your site, navigate to Plugins → Add New.
  2. Select the Upload option and click “Choose File.”
  3. When the popup appears, use it to select the Portfolio Slideshow .zip file for the plugin.
  4. Follow the on-screen instructions and wait as the upload completes.
  5. When it’s finished, activate the plugin via the prompt.


  • PHP 5.2.4 or greater (recommended: PHP 5.4 or greater)
  • WordPress 4.3 or above
  • jQuery 1.11.x


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. Please consider using a different theme, or at least contact the theme developer about these missing functions.

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 very well.


Plugin is broken

This plugin hasn’t worked for me since v1.5.1. As I can’t update it, I’ll need to migrate to an alternative.

This plugin is dead

Have used it for several sites before, but it gets more errors / bugs with every update. Would not recommend this plugin to anyone anymore. Since there is NO support and the plugin is filled with several BIG deal breaking issues. Sorry.
A HUGE update is a must to breath life into this plugin again but this do not seems likely to happen any day soon.

Couldn’t find where to add images even…

Wasn’t even able to figure out where to add portfolio images for the app after about 30 minutes and I’m not dummy… All I could find were the settings but no where could I actually add new portfolios and images. Waste of time, shouldn’t be that hard to figure some little plugin out.

Fix it, please!

This thing has become a horror show with ZERO support from the authors. I guess I get to go find another portfolio plugin…

Read all 90 reviews

Contributors & Developers

“Portfolio Slideshow” is open source software. The following people have contributed to this plugin.


Translate “Portfolio Slideshow” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • FIX: Make the “help” icon link in slides meta box go to a new page instead of leaving the current one.
  • TWEAK: Temporarily remove the “updated URL with Slide IDs” option.
  • TWEAK: Remove references to some pager features that don’t yet exist.
  • TWEAK: Remove references to some lightbox features that don’t yet exist.
  • TWEAK: Remove some internal references to the old Portfolio Slideshow website.


  • TWEAK: Safer translatable strings.
  • FIX: Ditched custom Underscores templating in place of safer and more widely-supported wp.template()
  • FIX: Fixed errors with missing “slide URL” attachment fields.


  • NEW: Restored full support for PHP 5.2 and higher!
  • NEW: Added “System Info” tab for use in support requests.
  • NEW: Made documentation translatable.
  • NEW: Added more documentation links for faster/more specific navigation.
  • TWEAK: Some JS cleanup to being laying the groundwork for the few releases of improvements.
  • TWEAK: added “support” and “settings” quick links to Plugins page.
  • TWEAK: Moved screenshots and some other assets to wp.org repo /assets folder – makes for a smaller plugin file and thus, hopefully, faster updates.
  • TWEAK: Reduced number of variables created in view includes.
  • TWEAK: Code cleanup in some of the views.
  • FIX: Fixed the “Slide URL” attachment field to ensure it saves.
  • FIX: Repaired functionality of the openurl and target attributes.
  • FIX: Fixed some max-width CSS to ensure images don’t pop out of their container.
  • FIX: Fixed bug that prevented centered="true" shortcode attribute from working.
  • FIX: Relocated and renamed many files for a more organized plugin structure to lay a foundation for future changes (heavily inspired by The Events Calendar).
  • FIX: Fixed a broken placeholder image src.
  • FIX: removal of references to erroneous plugin versions.
  • FIX: escape some translated strings that weren’t.
  • REMOVAL: Removed unused function portfolio_slideshow_is_plugin_active().
  • REMOVAL: Removed unused function portfolio_slideshow_get_image_sizes().
  • REMOVAL: Removed unused function portfolio_slideshow_sanitize_text_field_deep().
  • REMOVAL: Removed unused file ps-custom-post-type.js.
  • REMOVAL: Removed unused file ps-custom-post-type.css.
  • REMOVAL: remove all references to “fluid” / “allowfluid” option.


  • FIX: A few fixes to address the retrieval of slides, which should mean your pre-1.9.9 slideshows will work fine in many more cases than with the 1.9.9 release itself.
  • FIX: Fixed some “Undefined Index” PHP notices with a few slideshow arguments.
  • FIX: Removal of unnecessary “protected” access on several class methods and properties.
  • FIX: Removal of a handful of unnecessary JavaScript and CSS files that could cause 404 errors on pages if loaded.


  • Ported the existing plugin to PHP 5.3-compatible code and laid the foundation for some major changes in the next few versions: 1.10.x, and then 2.0.0