This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Portfolio Slideshow


A clutter-free slideshow plugin for WordPress

Portfolio Slideshow adds a simple slideshow builder to posts and pages on your site. Its drag-and-drop interface lets you upload, order, and edit images “on the fly” right on the page.

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.


  • 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.6.0 or greater (recommended: PHP 7.1 or greater)
  • WordPress 4.9 or above


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.


30 September 2019
A good plugin. Sadly it's currently broken. Would give it 5 stars if it worked.
29 Jun 2018
There seem to be a lot of negative reviews lately. I just updated the plugin on one of my sites which has just been updated to latest version of WP - and the gallery stopped working. But that was because when you update the gallery, you have to activate it again on the plugin page control panel.
23 Mei 2018
Also not working for me since version 1.5.1 which is a real shame because I previously liked this plugin. Please provide an update that works on newer versions of Wordpress! 🙁
8 November 2017
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.
4 Jun 2017
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.
Read all 88 reviews

Contributors & Developers

“Portfolio Slideshow” adalah perisian sumber terbuka. Orang-orang berikut telah menyumbang kepada pemalam ini.



1.13.0 2019-3-10

  • Fix — Fixed the too-long default transition speed; it’s now 1 second instead of 4 seconds.
  • Tweak — Increased the default timeout speed from 3 seconds to 4 seconds.
  • Removal — Removed survey notice added in 1.12.1.


  • Fix — Fixed a “non well-formed numeric value” PHP notice that would arise in the system info page.
  • Tweak — Bumped “Tested up to” version number.


  • Fix — Made the “help” icon link in slides meta box go to a new page instead of leaving the current one.
  • Tweak — Temporarily removed the “updated URL with Slide IDs” option.
  • Removal — Removed references to some pager features that don’t yet exist.
  • Removal — Removed references to some lightbox features that don’t yet exist.
  • Removal — Removed some internal references to the old Portfolio Slideshow website.


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


  • 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 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