Creating an image gallery | Civio Engage Knowledge Base       [ ![Civio Knowledge Base](/civio-light.svg) ](https://nginx.deploy-lagoon-production.engage-vic-docs.dh1.amazee.io)  [Articles](/articles)

   [Home](/)   [Knowledge base](/articles)   [✏️ Content tools](/articles?category=5)

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

Updated 1 year ago

    Search  Go

![](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)

 [    Back to articles ](/articles)

  Table of contents
-----------------

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