Galleries are a quick — but limited — way to display a number of images on a single page. In general, they should be avoided on this wiki. It is much preferred that individual images accompany blocks of text. However, they are acceptable in some situations, such as when displaying a series of covers. In some other cases, they are outright forbidden.

For details on how to create galleries, you can read the potted Wikia help file below. Even better is the more detailed help file, which explains the finer points of wiki markup for galleries.

Points to ponder

Wikia's explanation of galleries will tell you the simplest way to make a gallery. But it won't tell you much about how the function behaves in live examples. That's why we're providing some wisdom from actual case studies.

Put that add button away

Always hide the add photo button. If you don't add any options to your <gallery> tag, it will automatically show a button that invites users to add a photo the gallery. This is undesirable for several reasons:

  • It makes it easy for vandals or even just new users testing the wiki to ruin your gallery. With a couple of clicks, they can easily insert inappropriate images directly into your gallery.
  • It allows people to upload images without adding a proper copyright license. The add button completely bypasses the Licensing drop-down menu presented when you upload a file.
  • It makes the end of a particular gallery obvious. If you remove the button, you can put several galleries together in such a way that the join isn't obvious (so long as you haven't put a border around your galleries).

For these reasons, this wiki requires you to hide the add button by using this markup:

<gallery hideaddbutton="true">

Enough is enough

Don't go overboard with galleries. Theoretically, you can use galleries to display a very large number of images. This poses a problem for users who have slow connections. We're not just talking about those who use dialup. We mean almost everyone who's viewing on a smartphone, and many who are connected wirelessly.

Don't assume that everyone has a computer, or internet connection, as good as yours.

To help with this problem:

  1. Use .jpg files only. Other file types are either unscalable (which is vital to galleries) or far too high-quality for the purpose of galleries.
  2. Reduce the file-size of your gallery images to around or below 50kb. Certainly, don't go over 100kb with any one image. You can reduce your filesize most easily in Photoshop by saving for web (as opposed to normally saving), and dialing down the quality to around 20. Make the filesize of every image as small as you possibly can.
  3. Find a way to limit the total number of images in a single gallery structure. Do you really need all 200+ images of, say, Doctor Who Adventures covers on a single page? Or can you create a page for each publication year?

Watch your dimensions

Keep the dimensions of your images as equal as possible. The gallery function basically creates a series of thumbnails. But it's not like this kind of thumbnail:
No, the gallery thumbnail creates relative thumbnails. It considers all the images in the gallery and resizes them relative to each other, trying to put them into the specified width. (If you don't specify a width, it defaults to 200px.)

This can produce some highly unexpected results if you're trying to create a gallery of images with radically different dimensions.

the ratio of width to height

A image that is 800X400 has the same dimensions as one that is 400X200 —
but not one that's 137X877

Technically, there's always some level of distortion in a gallery, if the pics don't have the exact same dimension. But it is considerably less obvious if the files are all of the same dimensions.

Putting a lot of images of widely divergent dimensions in the same gallery often results in "warping" or "stretching" of some of the images.

To help with this problem:

  1. Try to use images that are all of the same dimensions. If you're displaying a series of magazine covers, for instance, it's a good idea to crop all of them to precisely the same dimensions. That way, they'll all be perfectly scaled down.
  2. If you must use a mixture of widescreen, 4:3, and extremely skinny images, don't put them all into the same gallery structure. Find a way to break up the galleries on the same page, so that the gallery command is not having to work so hard.

Rules of use

There are a few absolute rules which should be observed when using galleries. Failure to observe these rules could lead to a suspension of your editing rights:

  1. Never use a gallery for a single image. Single images should be placed on pages using the syntax:
    as described at Help:Files. There is simply no advantage to using the gallery structure for a single image; the wikitext for file display is invariably superior for the task.
  2. Always hide the add button. All galleries must begin with a command that looks like this:
    <gallery hideaddbutton="true">
  3. Never use galleries on in-universe pages.
  4. Use caution with galleries on story pages. Generally, they should be used only when displaying a series of alternate covers. There is no other reasonable usage for galleries on story pages. No story page should have a gallery of images from that story.

Standard Wikia help file

Galleries, Slideshows, and Sliders are simple tools to display your community's interesting photos and videos. However, Slideshows and Sliders are not recommended for the best user experience. Use them at your own risk.

A gallery presents static pictures and videos in grids. You have a lot of flexibility in determining the specifics of that grid and can even offer your readers the opportunity to add an image directly to the gallery.
A slider pans one image over another in a slow, timed fashion. It gives an animated way to introduce the four most important areas of your wiki. Readers can control the direction of the slider with the arrows on the sides—and they can jump to whatever page is linked to each image.
A slideshow is similar to a slider, but it can contain many more pictures. Unlike a slider, it gives no opportunity to present captions, so slideshows usually work better in situations where your images are iconic and therefore instantly recognized by your readers.

UCP: step-by-step to add a gallery

These instructions are for the 2017 editor used on the UCP.

  • Open the visual editor for any article page. Make sure the drop-down menu at the top of the editor is set to "Visual Editor".
  • If necessary, place the cursor in the editing area where you wish to position a gallery.
  • Click the INSERT drop-down menu in the editor toolbar and select Gallery. The gallery-building modal window will pop up.
  • In the "Search for media" text box, start typing the name of a File: page. As you type, images and videos that match your input will appear in the space below. Continue typing until you find the one you want and then click it to select it. When an image/video is selected, a thumbnail of it appears in the list to the right under the heading "In the Gallery" and the EDIT CAPTION text field appears below the larger version of the selected media.
  • You may enter a caption for it (or leave it blank) and click the blue check-mark at the end of the text field. You should briefly see the message "Caption successfully saved" and then the Search function reappears with your latest search results.
  • Continue to search for images/videos and select them until you are done.
  • At any time, you may modify the "In the Gallery" list in the following ways:
    • Remove an image or video by clicking the × below it
    • Edit the caption by clicking the pencil icon below it
    • Drag-and-drop images/videos within the list to change the presentation order
  • When you are done, click INSERT in the upper-right corner of the gallery builder window. The modal will close and the images/videos will appear in the edit window. NOTE: They may not appear in rows at first, or may have more items per row than will be displayed in the final product—you may have to save the page to see the correct formatting.
  • Once back in the Visual Editor for the page, clicking on any image in the gallery will show the Gallery EDIT button off to the side of the gallery and you may make further changes.
  • Save the page to preserve your changes.

Galleries offer many options to customize the user experience, but access to these, and to sliders and slideshows, are only available through the Source Editor and wikitext. See Help:Galleries, Slideshows, and Sliders/wikitext for detailed wikitext instructions.

Legacy: step-by-step

These instructions are for the classic editor on the legacy Fandom platform.

Gallery builder layout

Building a gallery

  • Open the classic editor for any article page. Make sure the tab at the top of the editor is set to "Visual".
  • In the right rail, under "Add features and media," select Gallery, Slider, or Slideshow.
  • A pop-up box will open. Select "Add a Photo" and follow the instructions on the screen until you have added all of the photos you would like included. You can choose to either upload new photos or select from existing photos on the community.
  • Set the captions, titles, or descriptions of your selected photos. This information will display below them and will help your readers know what they're about.
Slideshow builder

Building a slideshow

  • Set the size, orientation, borders, or other settings available for your final creation. These options may vary based on the tool you are using.
  • Click "Finish". Your photos will appear after you publish the page.

Note: Videos can also be used in galleries and sliders, though currently they can only be added via wikitext.



Example gallery-1


Example slider


Example slideshow

Read more

Further help and feedback

Community content is available under CC-BY-SA unless otherwise noted.

Fandom may earn an affiliate commission on sales made from links on this page.

Stream the best stories.

Fandom may earn an affiliate commission on sales made from links on this page.

Get Disney+