Joomla Gallery


The Gallery component is a minimalistic and completely file-based photo gallery for Joomla 2.5 and Joomla 3. File-based means that there is no need for a database and you could manage all your photos in just one place: the file system. The gallery is really simple to use: When you are creating a gallery, just upload your photos to the gallery folder and the whole gallery is automatically created.

The Joomla Gallery extension is the indirect successor of the Photoblog component.


You could find a demo of the Gallery component in the "Demos" section of the old project website.


The Gallery component for Joomla is published under the GNU AGPL v3 license. See for more details.

System Requirements

To run the Gallery on your Joomla! installation your server should satisfy the system requirements below:

Special Requirements for PHP 5.6 and higher

If you are using PHP 5.6 or higher, you need the PHP Fileinfo extension activated. This is the case by default for most PHP installations, but at some hosters you will need to activate it in the webspace settings.

Installation Instructions

  1. Download the component archive file.

  2. Install the package "" through the Joomla extensions manager.

  3. Create a new menu item for the gallery and set the path to the gallery folder relative to your Joomla root folder in the menu settings.

  4. Upload some JPG photos to the folder selected folder. You could do this through the Joomla media manager or via FTP. You are free to choose your own folder structure to organise your photos. The original photos shouldn't be to large, because the PHP memory limit would maybe exceeded when generating the preview photos or thumbnails for large photos. A maximum width and height of about 1600x1600 pixels should work fine.

  5. Access the gallery via the front-end. The first call of each folder could take some time because the preview photos and thumbnails are just generated.

Note: Breadcrumbs are used as navigation. So if you like to use navigation, you have to add a breadcrumbs module!

Known Bugs

Report Bugs

Please report bugs directly on GitHub with the provided functions. It would be really nice if you could report all bugs you will find in the gallery.