Search Over 30,000 FREE Plugins from the Official WordPress Plugin Directory Repository

Portfolio Slideshow

Add a clean, responsive JavaScript slideshow to your site.

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!

Author George Gecewicz
Contributors ggwicz, daltonrooney
  1. portfolio-slideshow screenshot 1

    Example gallery.

  2. portfolio-slideshow screenshot 2

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

  3. portfolio-slideshow screenshot 3

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

  4. portfolio-slideshow screenshot 4

    Settings control panel.

  5. portfolio-slideshow screenshot 5

    Finding the attachment ID for your images.

  6. portfolio-slideshow screenshot 6

    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


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

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.

Version 1.12.0

Requires WordPress version: 4.3 or higher

Compatible up to: 4.6.3

Last Updated 11 Sep 2016

Date Added: 23 Mar 2010

Plugin Homepage


4 stars
88 ratings


Not Enough Data

Works: 0
Broken: 0