Image Gallery Widget


This article covers specific setup and content entry for the Image Gallery Widget. If you've never set up a Widget, check the Setup Guides Section for a step by step guide for getting started.

The Image Gallery Widget allows you to configure a group of images with a lightbox, image title and additional caption that will be displayed on the front end of your store.

Widgets in Custom Fields do not require custom development. They come with all fields configured, as well as basic styling including CSS, Javascript and all metafield code needed. Widgets are also easily customized to suit your theme style or content entry requirements.   

The image below shows an un-styled version of an Image Gallery Widget.

Content Entry Form

While entering content, you can upload the image, create the title and add a caption using the default widget setup.

By default, the Widget's content entry form will include the following:

  • Image
    • The image for this item.
  • Title
    • A title to display when the image is activated.
  • Caption
    • A caption to display when the image is activated.

Theme Settings

  • Grid Size
    • How many images to display horizontally. This setting assumes the visitor's device is large enough to display the items horizontally, such as a desktop display. Has no impact on smaller screens like phones.
  • Hide Arrows
    • When selected, the navigation arrows on the right and left of the active image will be removed.


To edit configuration for this Widget, head into the Configure section in the sidebar under your item type, for example, under Products, choose Configure. Hover on the Widget to see options. 

Adding New Fields

From the Configure screen, select the plus to add more fields to this widget. 


Select the code symbol to edit the basic HTML and liquid code for this widget.

HTML and liquid in our templates may be edited in the app or directly in your theme. 

CSS can only be edited in your theme. The code page links to the correct theme file to edit the CSS. 

Javascript for this widget is not editable. You may use your own javascript or a library if you wish. Simply remove the css class "cf-auto-init" in the widget template to prevent the built-in javascript from firing.

Customizing Content Entry Fields

Some fields may have additional configuration options. For example, you might want to add some help text for your administrator on a particular field.