MaxGalleria – QuickStart



Getting Started

Getting started with MaxGalleria is as easy as activating the plugin, loading some images and clicking Publish Once you’ve downloaded the MaxGalleria platform, install it on your WordPress installation. Activate from your ‘Plugins’ page. Next, go to Settings->Permalinks and click the ’Save Changes’ button to add MaxGalleria’s gallery template to your site’s permalinks. Now head to the menu item called Galleries.

If you’d like to use your new gallery in a post or page, you can grab the shortcode in the bottom right of your Gallery Edit page, or use the “Add Gallery” option in the TinyMCE for your post.

From Galleries you have several options. You can go to your Galleries overview page, import a NextGen Gallery into MaxGalleria, adjust your MaxGalleria defaults, or get Support.

For now, let’s take a look at the Galleries page. Once there you can see your entire list of galleries as well as Add New galleries. Click Add New.

Adding Images

When you first get into your Gallery editor you’ll be prompted to select an Image or Video gallery. Currently MaxGalleria does not support galleries with both images and videos in the same gallery. First, create a title for your gallery. In this example we’ll use “My First Gallery.”

Adding Images is the same as in a post or page. Using the standard WordPress media library you can add previously added images or upload new images to your gallery. The larger the image size, the longer it will take to load so be patient as the images are getting loaded in.

Once the images have loaded you could press Publish and be done, or you can check out the other gallery options. We’ll get to those in a moment, but let’s talk about Videos.

Adding Videos

Much like Images, to add Videos, just click “Add Videos” and you’ll get a similar lightbox. Straight out of the box you’ll have the ability to add YouTube videos to your gallery by copying and pasting the video URL. You can add multiple videos at a time, one URL per line.

After clicking “Add To Gallery” your gallery will refresh and a thumbnail from the video or videos will appear as your gallery thumbnail images.

dFactory Responsive Lightbox

Starting with version 4.11 you will see a box suggesting the installation of the Responsive Lightbox plugin by dFactory. Responsive Lightbox contains six scripts including SwipeBox, prettyPhoto, FancyBox, Nivo Lightbox, Image Lightbox, Tos “R” Us.

You can choose to use Responsive Library for your gallery or albums by going to the Options Tab and setting ‘Thumbnail Click Opens’ to ‘Original Image.’

Then scroll down to Lightbox Settings and click the button next to Use dFactory Responsive Lightbox and you are good to go.

Adjusting Gallery Settings

With the core of MaxGalleria, you have the Image Tiles gallery ready for use. Below are the basic options available to both Video and Images in the Tile layout:

  1. Gallery Skin: MaxGalleria comes packaged with a few standard skins. Currently there are, No Border, Picture Frame, Portal, Portal Dark, Standard, Standard Dark, Tightness and Tightness Dark. Each skin is different in some way, but if you can’t find one that suits your gallery, you can make your own (more on that later).
  2. Thumbnail Columns: Depending on how many videos or images you have in your gallery you may want a different amount of columns. MaxGalleria defaults to five columns, but you can choose anywhere between 1 and 10. Whatever column selection you make, your gallery will stick to that and is responsive, so you’ll have the same number of columns on all devices (larger numbers will adjust automatically on mobile).
  3. Thumbnail Shape: Three options here with Square, Landscape and Portrait. Landscape is especially nice for videos which tend to be in a 16:9 ratio already, converting well to the Landscape shape.
  4. Thumbnail Captions Enabled: For each image you have the ability to add/edit captions. If you’d like those captions to appear when the gallery loads, you’d want to check the checkbox for this option.
  5. Thumbnail Click Opens: End result of a user clicking the thumbnails in the gallery. Options are Lightbox Image, Image Page (Attachment Page), Image Link (the link you’ve set for that image) and Original Image (direct URL of image).
  6. Thumbnail Click New Window: For all options other than Lightbox Image, this indicates where the link of the thumbnail will be opened, a new window or the same window. Unchecked it will open in the same window.
  7. Thumbnail Custom Image Class: Adds a class to every image.
  8. Thumbnail Custom Image Container Class: Adds a class to the image container.
  9. Thumbnail Custom Rel Attribute: Changes the Rel Attribute of the image. The default allows clicking prev/next inside the lightbox to get between the images.
  10. Lightbox Captions Enabled: Much like the captions above, this indicates whether or not, when the lightbox is open, if the captions will show.
  11. Images Per Page: To have video or image tiles appear on more than one page, enter a number here to turn on pagination and to indicate the maximum number of images/videos that should appear on each page.
  12. Lazy Load Enabled: Allows images to be loaded as needed as they come into view in the browser; it increases page load times especially for pages with large images or with a large number of images in a gallery.
  13. Lazy Load Threshold: The number of pixels above the image when lazy loading should begin. The default setting is 0 or none.
  14. Use dFactory Responsive Lightbox: When checked MaxGalleria uses a lightbox from the Responsive Lightbox by dFactory plugin. When this option is checked ‘Thumbnail Click Opens’ has to be set to ‘Original Image’ or ‘Image Link’

Magnific Popup Options (Only in the Pro version. These settings apply when Thumbnail Click Opens is set to Lightbox Image.)

  1. Align Top Enabled: This will align the top of the image to the top of the page rather than center to image vertically.
  2. Close on Background Click Enabled: Will close the lightbox when the user clicks on the lightbox background.
  3. Close with Escape Key Enabled: Closes the lightbox popup when the escape key is pressed.
  4. Fixed Content Position: The ‘Auto’ selection will set the lightbox’s popup position to be fixed (it can not be scrolled up or down) if the browser supports that property. Selecting ‘On’ will set the popup position to be fixed even if the browser does not support it. Selecting ‘Off’ will allow the lightbox’s popup to be scrolled up or down.
  5. Hide Close Button: Removes the close button that appears on the top right of the lightbox popup.
  6. Lightbox Captions Enabled: Will display the image’s caption below the image in the lightbox.
  7. Overflow Y: When Fixed Content Position is set to ‘Auto’ or ‘On’ this option will display a vertical scroll bar when it is set to ‘Auto’ or ‘Scroll’.
  8. Popup Custom Class: Adds a class to the popup that can be used for adding CSS styling to the popup.
  9. Removal Delay: Specifies the amount of time, in milliseconds, before removing the popup.
  10. Retina Images Enabled: This option allows for the display of high resolution images in place of normal resolution images on high-dpi screens with different a devicePixelRatio. To accomplish this first add normal resolution images to a gallery. Then upload matching high resolution images directly to the WordPress media library. The high resolution images should have file names ending in ‘@2x’; example: image.jpg & image@2x.jpg. The image should have the same URL path as their matching normal resolution images.
  11. Vertical Fit Enabled: Will shrink the size of the image proportionally according to the available height.
  12. Zoom Enabled: Displays a zoom effect when opening and closing a lightbox image. This effect is not available for video tiles.
  13. Zoom Easing: Specifies the CSS3 type of easing. Choices include ease-in-out, ease-in, ease-out, ease and linear.
  14. Zoom Duration: Sets the amount of time for the zoom effect in milliseconds.
  15. Gallery Enabled: When the gallery option of the lightbox is enabled the user can move between the different images or videos in the current gallery by using previous and next arrow buttons that are displayed in the light box.

Gallery Options – Only in the Pro version. These are only available when the Gallery Enabled option is checked.

  1. Navigate By Image Click Enabled: When this option is checked clicking on an image will display the next image in the gallery.
  2. Arrow Button Mark-up: This option allows you to specify the HTML and CSS selectors of the arrow buttons. The default is [button title=’%title%’ type=’button’ class=’mfp-arrow mfp-arrow-%dir%’]. Note that this field does not accept double quote marks. ‘%title%’ will be replaced by the image’s caption if there is one and ‘%dir%’ will be replaced by arrow direction, either ‘left’ or ‘right’.
  3. Left Button Title: Specifies the title attribute of the left button. The default is ‘Previous (Left arrow key)’
  4. Right Button Title: Specifies the title attribute of the right button. The default is ‘Next (Right arrow key)’
  5. Counter Mark-up: Specifies the HTML and CSS selectors of the counter text on the bottom, right side of the popup. Note that this field does not accept double quote marks. The default mark-up is “%curr% of %total% magnific-popup/documentation.html 

Gallery Description

For each gallery you can create a description that discusses your gallery or adds extra information for anyone viewing the gallery. If enabled, you can choose to put the description above or below your gallery (default is above).


The import/export feature of MaxGalleria Pro allows one to export one or more image or video galleries from one WordPress website to another. The import/export feature does not export albums.


If used with Media Library Folders or Media Library Folders Pro, note that these plugins are not required, then you would need to ensure that the latest versions of these plugins have been installed: Media Library Folders version 8.1.9 or newer; Media Library Folders Pro version 8.2.5. or newer.

Create A New Export File

A gallery export file can contain any number of galleries with their images and videos. Click the Create New Gallery Export File button to create a new export file. This will display a popup window for selecting one or more galleries and entering an export file name. The first gallery selected will be used as the file name, but this can be changed. After choosing the galleries to export, click the Create button.

Once the export file has been generated, it will appear in the import/export file list, and it can be downloaded by clicking the file’s download icon under the Actions column on the right side of the page.

To upload the export file to another site using MaxGalleria Pro, view the MaxGalleria Pro Import/Export page, click the Upload a Gallery Export File button, and select the file to upload. While the file is uploading, you can cancel the upload.

Note: Export files generated by MaxGalleria will have ‘-mpg’ appended to the end of the file name, and files exported from Media Library Folders Pro will have ‘-mlfp’ appended to the end of their export file names. Media Library Folders Pro export files can not be imported into MaxGalleria and vice versa.

Once the upload has been completed, it will appear in the import/export file list. Click the file Import icon in the Actions column on the right side of the page to import the file contents.

When the import process has been completed, visit each new gallery’s option page, check that the desired options are selected, and click the Update button. Your gallery is now ready to view.

Finally, if the export file is no longer needed, it can be removed by clicking its Delete icon.

Front End Uploading

To enable front end uploading, first go to your MaxGalleria Pro Settings and check the box “Allow Front End Uploading” and then save the settings.

Edit the page on which you’d like to have frontend uploading enabled and add this shortcode:

[mg-image-file-upload folder_path=”” display_image=”1″ gallery=””]

The shortcode has four parameters:

folder_path the path to folder where you want to store the gallery images, example, “example-site/https_docs/”. You may need to use your site’s file manager to get the path to your destination folder. Note, the folder path is different than the URL. A URL start with ‘http’ or ‘https’ and will not work for the folder_path parameter.
display_image – “1” to display the uploaded image or “0” for no display.
file_types – by default, only images file types are allowed. If not included, all WordPress image file types are allowed. To restrict file types, create a comma separated list of allowed file types, file_types=”jpg, png, webp”
gallery – The ID number of the destination gallery; the gallery ID number can be found by looking at the link of the edit page of a gallery, which will like this this: The number that comes after the ‘post=’ is the ID number of the gallery.
Here is an example of a complete shortcode:

[mg-image-file-upload folder_path=”example-site/https_docs/″ display_image=”0″ gallery=”432″]

In this example, uploaded images will be added to the gallery with the ID of 432 and stored in uploads/2024/05 folder.

When images are added to a gallery, they are automatically excluded from being displayed. A site administrator needs to open the gallery page and change the status of excluded images for them to be displayed on the front end of the site.

Advanced Options

MaxGalleria allows you to load your own styles and scripts if you want to add anything to the options MaxGalleria already provides. Simply use the URL of the stylesheet or JavaScript file, click “Enabled” and the scripts and styles will be loaded after the necessary MaxGalleria files.

From here you can also reset all of the gallery options to the defaults by checking the Reset option. The action cannot be undone and you will lose any previously saved options for that gallery.

Note: If you changes themes be sure that the new theme contains a copy of the file ‘single-maxgallery.php’ which you can find in the MaxGalleria plugin folder.



» maxgalleria_gallery_post_type_labels

» maxgalleria_gallery_post_type_args

» maxgalleria_gallery_columns

» maxgalleria_image_tiles_lightbox_stylesheet

» maxgalleria_image_tiles_main_stylesheet

» maxgalleria_image_tiles_skin_stylesheet

» maxgalleria_image_tiles_easing_script

» maxgalleria_image_tiles_lightbox_script

» maxgalleria_image_tiles_main_script

» maxgalleria_image_tiles_before_gallery_output

» maxgalleria_image_tiles_after_gallery_output

» maxgalleria_image_tiles_gallery_output

» maxgalleria_image_tiles_before_thumb

» maxgalleria_image_tiles_after_thumb

» maxgalleria_image_tiles_thumb

» maxgalleria_video_tiles_lightbox_stylesheet

» maxgalleria_video_tiles_main_stylesheet

» maxgalleria_video_tiles_skin_stylesheet

» maxgalleria_video_tiles_lightbox_script

» maxgalleria_video_tiles_main_script

» maxgalleria_video_tiles_before_gallery_output

» maxgalleria_video_tiles_after_gallery_output

» maxgalleria_video_tiles_gallery_output

» maxgalleria_video_tiles_before_thumb

» maxgalleria_video_tiles_after_thumb

» maxgalleria_video_tiles_thumb

» maxgalleria_video_api_url

» maxgalleria_video_attachment

» maxgalleria_video_embed_code

» maxgalleria_video_thumb_url

» maxgalleria_youtube_regex_patterns

» maxgalleria_before_gallery_thumb

» maxgalleria_after_gallery_thumb

» maxgalleria_gallery_thumb

» maxgalleria_thumb_size_landscape_one_column

» maxgalleria_thumb_size_landscape_two_column

» maxgalleria_thumb_size_landscape_three_column

» maxgalleria_thumb_size_landscape_four_column

» maxgalleria_thumb_size_landscape_five_column

» maxgalleria_thumb_size_landscape_six_column

» maxgalleria_thumb_size_landscape_seven_column

» maxgalleria_thumb_size_landscape_eight_column

» maxgalleria_thumb_size_landscape_nine_column

» maxgalleria_thumb_size_landscape_ten_column

» maxgalleria_thumb_size_portrait_one_column

» maxgalleria_thumb_size_portrait_two_column

» maxgalleria_thumb_size_portrait_three_column

» maxgalleria_thumb_size_portrait_four_column

» maxgalleria_thumb_size_portrait_five_column

» maxgalleria_thumb_size_portrait_six_column

» maxgalleria_thumb_size_portrait_seven_column

» maxgalleria_thumb_size_portrait_eight_column

» maxgalleria_thumb_size_portrait_nine_column

» maxgalleria_thumb_size_portrait_ten_column

» maxgalleria_thumb_size_square_one_column

» maxgalleria_thumb_size_square_two_column

» maxgalleria_thumb_size_square_three_column

» maxgalleria_thumb_size_square_four_column

» maxgalleria_thumb_size_square_five_column

» maxgalleria_thumb_size_square_six_column

» maxgalleria_thumb_size_square_seven_column

» maxgalleria_thumb_size_square_eight_column

» maxgalleria_thumb_size_square_nine_column

» maxgalleria_thumb_size_square_ten_column

» maxgalleria_gallery_widget_stylesheet

» maxgalleria_gallery_widget_before_output

» maxgalleria_gallery_widget_after_output

» maxgalleria_gallery_widget_output

» maxgalleria_gallery_widget_before_thumb

» maxgalleria_gallery_widget_after_thumb

» maxgalleria_gallery_widget_thumb

» maxgalleria_gallery_widget_before_view_more

» maxgalleria_gallery_widget_after_view_more

» maxgalleria_gallery_widget_view_more

» maxgalleria_gallery_widget_before_thumb_output

» maxgalleria_gallery_widget_after_thumb_output