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>