Creating an image gallery | Civio Engage Victoria Knowledge Base     [Skip to content](#main)  [ ![Civio Engage Victoria Knowledge Base](/civio-light.svg) ](https://nginx.deploy-lagoon-production.engage-vic-docs.dh1.amazee.io)  [Product documentation](/articles)   Toggle navigation      

  [Product documentation](/articles)  

  1. [Home](/) ›
2. [Product documentation](/articles) ›
3. [Content tools](/articles?category=5) ›
4. Creating an image gallery

 Creating an image gallery
=========================

Updated 2 years ago · 2 min read

 Search     Search  

![](https://downloads.intercomcdn.com/i/o/761274291/c7fabb6c3670da43971eedfc/image.png)

Instructions for optimal image display
--------------------------------------

**Supported file types**jpeg, jpg, png**Max. file upload size**20 MB**Max. dimensions**If the image is larger than 5000 px to 5000 px, it automatically resizes the image down to the largest axis.

Therefore we recommend the following maximum dimensions for both axes: Width = 5000 px , Height = 5000 px .**Recommended aspect ratio**The platform allows for upload of images with any ratio. However, the images in the image gallery view will be fitted to the selected ratio for the image gallery: 16:9, 4:3, 1:1, 21:9, 3:1, 16:9 (portrait), 3:1 (portrait), 4:3 (portrait). When clicking on an image in the gallery, the full image will open in a lightbox in its original image ratio.Creating an image gallery
-------------------------

To create an image gallery:

1. Navigate to the page where you want to add an image gallery.
2. Click **Edit**. The Edit page will now open.
3. Click on **Add block** on the bottom of the page. In the dropdown, select the **Image gallery** block type.
4. Enter a **Title** for your image gallery.
5. In the **Display as** field, make sure the Thumbnail gallery with lightbox is selected.
6. In the **Display ratio** field, select a ratio from the drop down. The available ratios are: 16:9, 4:3, 1:1, 21:9, 3:1, 16:9 (portrait), 3:1 (portrait), 4:3 (portrait). This ratio determines how the images are displayed in the actual image gallery.
7. Add the images to your gallery through clicking **Add images**.
8. For each image that you add, you will be presented with the following fields:

    1. Image (required)
    2. Alt text (required): Alternative text, the text that describes the appearance or function of an image on a page. This text is read aloud by screen readers used by visually impaired users, displays in place of an image if it fails to load and is indexed by search engine bots to better understand the context of your page.
    3. Caption (optional): The descriptive text displayed under the image (max. 200 characters). Basic html tags including <a>, <strong>, and <em> can be used to format the caption.
9. Once you have added the images to your gallery, click **Add block**.
10. Click **Publish** to publish the gallery.

![](https://downloads.intercomcdn.com/i/o/766523043/02a535235a6150018cb2422d/image.png)

![](https://downloads.intercomcdn.com/i/o/766519775/653d63d7d744ec24623acbce/image.png)

Was this article helpful?
-------------------------

Your feedback helps us prioritise what to rewrite.

      Yes     No  

 [    Back to Content tools ](/articles?category=5) 

 On this page 

**Need additional help?** Submit support requests at the [Engage Victoria contact form](https://digital-vic.atlassian.net/servicedesk/customer/portal/35/group/97/create/354).

 © 2026 [Civio](https://civ.io)