TYPO3 Extension Grid Gallery

DonateLatest Stable VersionTYPO3License

This extension adds a modern grid gallery content element to your TYPO3 website.

1. Introduction


  • Based on extbase & fluid
  • Simple and fast installation
  • No configuration needed
  • No user-side image-manipulation needed
  • Fully responsive
  • Support for high resolution screens



Smartphone Example


Tablet Example


Desktop Example

2. Installation

Installation using Composer

The recommended way to install the extension is by using Composer. In your Composer based TYPO3 project root, just do composer req lavitto/typo3-gridgallery.

Installation from TYPO3 Extension Repository (TER)

Download and install the extension gridgallery with the extension manager module.

3. Minimal setup

  1. Include the static TypoScript of the extension.
  2. Create a grid gallery content element on a page

4. Administration

Create content element

  1. Create a new content element and select "Grid Gallery"

Create content element

Add images and set options

  1. Simple upload or add media files (currently only images are supported!)
  2. Enable/disable click-enlarge function
  3. Override default row height
  4. Override default margins

Add images and set options

5. Configuration


This default properties can be changed by Constant Editor:

PropertyDescriptionTypeDefault value
templateRootPathPath of Fluid Templatesstring<i>null</i>
partialRootPathPath of Fluid Partialsstring<i>null</i>
defaultRowHeightDefault height of each gallery row in pixelsinteger150
defaultRenderFactorDefault render factor of gallery images. Rendered image height = defaultRowHeight * defaultRenderFactorfloat1.5
defaultMarginsDefault margin between the images in pixelsinteger2
defaultCaptionsEnable to show captions by defaultbooleantrue
defaultRandomizeEnable to randomize the image-order by defaultbooleanfalse
defaultLastRowDefault value to handle the last rowoptionsnojustify
defaultBorderDefault space around the content elementinteger-1
thumbnailCropVariantThis crop variant is used to generate the thumbnailsstringthumbnail
lightboxCropVariantThis crop variant is used to generate the lightbox imagestringdefault
captionFieldsThe content of these field(s) will be used to generate the caption (if captions are enabled). Fieldnames separated by commas and ordered by priority (example: "description, title, alternative")stringdescription
enableJqueryIncludes jQuery to the pagebooleanfalse

6. Contribute

Please create an issue at https://gitlab.com/lavitto/typo3-gridgallery/issues.

Please use GitLab only for bug-reports or feature-requests. For support use the TYPO3 community channels or contact us by email.

7. Support

If you need private or personal support, contact us by email on info@lavitto.ch.

Be aware that this support might not be free!