Skip to content

Component library

Gallery component

Last updated 2 November 2026

Creates a responsive gallery that lazy loads images from thumbnails.

Live demo

<ins-gallery 
  with-indicator
  tooltip="This is a sample tooltip content. It also support html content."r>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/c1530bb4-702c-4a90-8713-6a8ea41e5b33/t1.jpg?updated=1722590369"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/f925ad9c-495b-4fb0-ab44-d57856d1384a/1.jpg?updated=1722590364">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/da371b63-85c2-4948-a344-7da8dcbd6d6f/t2.jpg?updated=1722590370"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/9a7b6d6a-19e4-4c53-ba24-e8d5e04eee38/2.jpg?updated=1722590365">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/4cdc8052-8d1a-42d3-adb5-56ccbd6849f7/t3.jpg?updated=1722590372"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/2c695ef2-c1cb-4fe6-b5fa-d01be347c109/3.jpg?updated=1722590366">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/db16a855-12f0-4e8e-aa8a-6ef4d554fed7/4.jpg?updated=1722590368"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/b1e71f80-d6c0-45c3-91af-2fc997e58d44/t4.jpg?updated=1722590373">
  </ins-gallery-image>

</ins-gallery>

Attributes

<ins-gallery> Attributes

FIELD ATTRIBUTE TYPE DEFAULT OPTIONS DESCRIPTION
img-alt string - - Sets the gallery img alt attribute.
img-title string - - Sets the gallery img title attribute.
zoomable boolean false true, false Renders a zoom element that appears on image hover
slidable boolean false true, false Defines if the gallery image can be navigated with slide events but not zoomable
with-indicator boolean false true, false Hide or show the image indicator
thumbnail-layout string inline inline, slider Defines the layout of the gallery thumbnails

<ins-gallery-image> Attributes

FIELD ATTRIBUTE TYPE DEFAULT OPTIONS DESCRIPTION
thumbnail string - - Defines the img src for the image thumbnail
image string - - Defines the img src for the gallery image
img-alt string - - Sets the image thumbnail's img alt attribute.
img-title string - - Sets the image thumbnail's img title attribute.

Event

EVENT OBJECT DESCRIPTION
insChange index, src, target Execute a script when gallery slide is changed

Method

EVENT PARAMS DESCRIPTION
activate index Use for manually activating gallery slide via index

Examples

Zoomable State

<ins-gallery 
  zoomable>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/c1530bb4-702c-4a90-8713-6a8ea41e5b33/t1.jpg?updated=1722590369"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/f925ad9c-495b-4fb0-ab44-d57856d1384a/1.jpg?updated=1722590364">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/da371b63-85c2-4948-a344-7da8dcbd6d6f/t2.jpg?updated=1722590370"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/9a7b6d6a-19e4-4c53-ba24-e8d5e04eee38/2.jpg?updated=1722590365">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/4cdc8052-8d1a-42d3-adb5-56ccbd6849f7/t3.jpg?updated=1722590372"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/2c695ef2-c1cb-4fe6-b5fa-d01be347c109/3.jpg?updated=1722590366">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/db16a855-12f0-4e8e-aa8a-6ef4d554fed7/4.jpg?updated=1722590368"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/b1e71f80-d6c0-45c3-91af-2fc997e58d44/t4.jpg?updated=1722590373">
  </ins-gallery-image>

</ins-gallery>

Slidable State

<ins-gallery 
  slidable>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/c1530bb4-702c-4a90-8713-6a8ea41e5b33/t1.jpg?updated=1722590369"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/f925ad9c-495b-4fb0-ab44-d57856d1384a/1.jpg?updated=1722590364">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/da371b63-85c2-4948-a344-7da8dcbd6d6f/t2.jpg?updated=1722590370"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/9a7b6d6a-19e4-4c53-ba24-e8d5e04eee38/2.jpg?updated=1722590365">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/4cdc8052-8d1a-42d3-adb5-56ccbd6849f7/t3.jpg?updated=1722590372"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/2c695ef2-c1cb-4fe6-b5fa-d01be347c109/3.jpg?updated=1722590366">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/db16a855-12f0-4e8e-aa8a-6ef4d554fed7/4.jpg?updated=1722590368"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/b1e71f80-d6c0-45c3-91af-2fc997e58d44/t4.jpg?updated=1722590373">
  </ins-gallery-image>
</ins-gallery>

Slider Thumbnail Layout

<ins-gallery 
  thumbnail-layout="slider">

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/c1530bb4-702c-4a90-8713-6a8ea41e5b33/t1.jpg?updated=1722590369"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/f925ad9c-495b-4fb0-ab44-d57856d1384a/1.jpg?updated=1722590364">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/da371b63-85c2-4948-a344-7da8dcbd6d6f/t2.jpg?updated=1722590370"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/9a7b6d6a-19e4-4c53-ba24-e8d5e04eee38/2.jpg?updated=1722590365">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/4cdc8052-8d1a-42d3-adb5-56ccbd6849f7/t3.jpg?updated=1722590372"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/2c695ef2-c1cb-4fe6-b5fa-d01be347c109/3.jpg?updated=1722590366">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/db16a855-12f0-4e8e-aa8a-6ef4d554fed7/4.jpg?updated=1722590368"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/b1e71f80-d6c0-45c3-91af-2fc997e58d44/t4.jpg?updated=1722590373">
  </ins-gallery-image>

</ins-gallery>

Slidable image with slider thumbnail layout

<ins-gallery 
  thumbnail-layout="slider">

   <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/c1530bb4-702c-4a90-8713-6a8ea41e5b33/t1.jpg?updated=1722590369"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/f925ad9c-495b-4fb0-ab44-d57856d1384a/1.jpg?updated=1722590364">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/da371b63-85c2-4948-a344-7da8dcbd6d6f/t2.jpg?updated=1722590370"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/9a7b6d6a-19e4-4c53-ba24-e8d5e04eee38/2.jpg?updated=1722590365">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/4cdc8052-8d1a-42d3-adb5-56ccbd6849f7/t3.jpg?updated=1722590372"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/2c695ef2-c1cb-4fe6-b5fa-d01be347c109/3.jpg?updated=1722590366">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/db16a855-12f0-4e8e-aa8a-6ef4d554fed7/4.jpg?updated=1722590368"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/b1e71f80-d6c0-45c3-91af-2fc997e58d44/t4.jpg?updated=1722590373">
  </ins-gallery-image>

</ins-gallery>

Activate Method

<ins-gallery 
  id="galleryEl"
  with-indicator
  tooltip="This is a sample tooltip content. It also support html content."r>

  <ins-gallery-image
                     thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/c1530bb4-702c-4a90-8713-6a8ea41e5b33/t1.jpg?updated=1722590369"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/f925ad9c-495b-4fb0-ab44-d57856d1384a/1.jpg?updated=1722590364">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/da371b63-85c2-4948-a344-7da8dcbd6d6f/t2.jpg?updated=1722590370"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/9a7b6d6a-19e4-4c53-ba24-e8d5e04eee38/2.jpg?updated=1722590365">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/4cdc8052-8d1a-42d3-adb5-56ccbd6849f7/t3.jpg?updated=1722590372"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/2c695ef2-c1cb-4fe6-b5fa-d01be347c109/3.jpg?updated=1722590366">
  </ins-gallery-image>

  <ins-gallery-image
    thumbnail="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/db16a855-12f0-4e8e-aa8a-6ef4d554fed7/4.jpg?updated=1722590368"
    image="https://files.prod01-insites.io/instances/302/property_uploads/modules/insites_assets/assets_upload/asset/b1e71f80-d6c0-45c3-91af-2fc997e58d44/t4.jpg?updated=1722590373">
  </ins-gallery-image>

</ins-gallery>

<ins-input
  id="galleryInput"
  label="Index"
  tooltip="Minimum 0; Maximum 3">
</ins-input>
<ins-button
   id="btnGallery"
  label="Select"
  solid>
</ins-button>

<script>
  const galleryEl = document.getElementById('galleryEl');
  galleryEl.addEventListener('insChange', event => {
    console.log(event);
  });

  const galleryInput = document.getElementById('galleryInput');
  const btnGallery = document.getElementById('btnGallery');
  btnGallery.addEventListener('insClick', () => {
    galleryEl.activate(galleryInput.value);
  });
</script>