Plugin Directory

Test out the new Plugin Directory and let us know what you think.
!This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

WP Supersized

Full screen background slideshow in any page/post, with images from WP Media Gallery, NextGEN Gallery, Flickr, Picasa, Smugmug, folder, or XML file

How do I display WordPress Media Library images with Supersized ?

Simply attach images from the WordPress Media Library to your new post or page. You do not need to insert them in the post/page, only attach them. The images will be shown by Supersized in the menu order. So moving them up or down the list in the Media Gallery menu will have the effect of changing their order when displayed by WP Supersized. WP Supersized will use the caption defined in the Media Gallery. If it is not present, it will use the image title (filename). To let WP Supersized know that it should display the images from the Media Gallery, select WP Gallery in the Supersized meta box (below the editor) in the page/post editor. If you have used the SupersizedDir custom field before, do not worry, your data is not lost; it is simply shown in an easier way. You do not need to fill in the custom field yourself anymore. Posts or pages using the Media Gallery images will all use the options defined in the plugin admin.

How do I display NextGEN Gallery images with Supersized ?

Simply use NextGEN Gallery as you would normally to define galleries. The images will be shown by Supersized in the order that you chose in NextGEN. So moving them up or down the list in the NextGEN Gallery menu will have the effect of changing their order when displayed by WP Supersized. For the caption, WP Supersized will use the Description field that you defined in your NextGEN gallery. If it is not present, it will use the image Alt&Title field, also defined in NextGEN. To let WP Supersized know that it should display the images from the NextGEN Gallery, select NextGEN Gallery in the Supersized meta box (below the editor) in the page/post editor. To select the NextGEN gallery that you want to use on this page/post, choose it in the WP Supersized panel or in the plugin options. Posts or pages using the NextGEN Gallery images will all use the options defined in the plugin options.

What should I do to use a different images folder for each post/page ?

There are several ways to do it:

  • Use the WP Media Gallery (see above)
  • Use the NextGEN Gallery (see above)
  • Use an XML file (see below) to define your list of images

Alternatively, you may create folders containing images for specific pages/folders: 1. Create a folder that will contain your images in your wp-content folder, e.g. the folder /wp-content/images_for_post_1 will contain the images for a particular post. It is also possible to create folders inside folders, e.g. /wp-content/images/images_for_page_x. 2. Once the folder(s) created, add the desired images there. 3. In the post/page editor, select the folder that you want to use from the list displayed in the Supersized meta box below the editing window (only folders are displayed).

How do I set up different options on each page/post for choosing how to display Supersized and which images it uses ?

From version 2.0, WP Supersized allows advanced users to choose almost all options separately for each page/post, including:

  • Almost all options available in the plugin options.
  • The list of slides to use (URL).
  • The list of thumbnails to use (URL).
  • The caption (title) to use for each slide. HTML and links can also be used within this caption.
  • The link (URL) where the user will be directed when clicking on the image background (individually for each image).

Details of how to use the XML file can be found in the example.xml file provided in the WP Supersized plugin folder. Simply make a copy of this file in your wp-content directory or another location within this directory, rename it, and edit it as you wish.

To use an XML file, go to the page/post editor and select the option in the page/post Supersized meta box below the editing window. You also need to enter the path inside the wp-content directory and the name of the XML file in the XML file field. IMPORTANT: if you use xml files for defining your images, two slides field names must be renamed from version 3.0: slide-link to slide_link and slide-thumb to slide_thumb in the xml files.

For example, if you want to use an xml file containing specific options and/or slides for a particular page/post, let's suppose that you have copied the example.xml file and created a file called my_slides_list_and_options.xml in directory wp-content/my_wpsupersized_slides_definitions (choose the names as you wish). You would then need to enter my_wpsupersized_slides_definitions/my_slides_list_and_options.xml in the Supersized meta box below the editing window. That's all, WP Supersized will now use your own definitions of the slides/options on this particular page/post.

WP Supersized will use default options (as defined in the plugin admin) for any options not defined in the XML files. Similarly, if you do not define any slides within your XML file, the default directory slides (usually in the supersized-slides directory) will be used.

WP Supersized is installed and activated, my slides folder contains images, and I have set up the options to show Supersized. Why is the Supersized slideshow still not visible ?

In order to see the slideshow, you must make sure that the background of the current page/post is at least partly transparent or leaves some transparent space around it. If you want your page/post to appear over a semi-transparent background that lets the Supersized slideshow visible, you should modify the css of your template(s). Here is a useful link showing the css needed for a cross-browser transparent background.

How can I have links in the captions of the images ?

This is not available for the default or custom folders as captions for images from these are extracted from the IPTC caption field of the file. You have several possibilities to have links in the captions:

  • If you use the WP gallery, you can simply type html code (including links) in the caption field of the images. It will then be displayed automatically by WP Supersized.
  • If you use the NextGEN gallery, same principle but you need to type it in the description field.
  • The last way to do it is to use an xml file (as explained in the FAQ and in the example.xml file). There, you can put html code in the title field

Why does Supersized not work with Internet Explorer 6 ?

Sam Dunn has made the choice not to support IE6 anymore. If you are still using IE6, you should seriously think about upgrading!

Supersized does not resize the images correctly in Internet Explorer

Although it seems to appear only sporadically, this was a known bug of Supersized 3.1.x. The latest version of Supersized (from 3.2.4) used in this plugin should solve this issue but is not yet available for the flickr mode.

Why are images not resized to full screen on iPads or some Android tablets ?

It has been reported that Supersized images are not resized correctly on iPad and Android tablets. As far as I know, this is mostly due to the way they are handling images and their interpretation of some css. There is currently no clear solution for this.

What are the image formats that can be used with Supersized ?

Since version 1.2 of WP Supersized, the following formats are recognized: jpg, jpeg, gif, png.

Why are only default images or an image indicating an error displayed when my WordPress installation has its own folder ?

If you see an image indicating an error, it should point you to one of the possible causes for this problem. First of all, make sure to update to the latest version of the plugin. If the issue is still present, there is probably a problem with file access permissions on your server. This has mostly been observed when running servers based on Windows. Try changing access rights to your image folder to solve this. It could also be that your provider has disabled the glob() function in php. Some providers seem to have done this to avoid a security issue with glob() in versions of php earlier than 5.2.4. It is not necessary anymore from php version 5.2.4 and higher so there should be no reason to leave the glob() function disabled. If you are in this case, contact your provider and ask them to enable the glob() function. Thanks to Sandro for finding out about this.

Where is the SupersizedDir custom field ?


At the bottom of the page/post you are creating/editing, you should see a box called Custom Field. If it is not visible, go to Screen Options (top right of the page) and check Custom Field. In the Custom Field box, enter the new Custom Field name SupersizedDir (next time, it will appear automatically in the list of Custom Field names). According to what you want to do, you can then give it a value that is the name of the folder to use for this particular post/page, or the value wp-gallery to use the WordPress Media Gallery, or (for advanced users) the location of an xml file containing all slides, titles, links, and options for this particular page/post.

Requires: 3.1 or higher
Compatible up to: 3.6.1
Last Updated: 4 years ago
Active Installs: 7,000+


4 out of 5 stars


1 of 1 support threads in the last two months have been marked resolved.

Got something to say? Need help?


Not enough data

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

100,2,2 100,1,1 100,5,5 67,3,2 100,2,2 100,2,2 100,1,1
100,2,2 100,1,1
92,12,11 50,2,1 100,1,1
100,4,4 0,1,0 0,1,0
0,3,0 67,3,2 50,2,1 7,14,1
17,6,1 100,3,3