Multi-image field

Add multiple images to your collection items and connect them to Collection lists and lightbox media on Collection pages.

The UI in this lesson may seem different if you've enables the Style Panel Beta! This content will be updated soon!
This video features an old UI. Updated version coming soon!
This video features an old UI. Updated version coming soon!

The Multi-image Field is a Collection field that allows you and your collaborators to upload multiple images for your Collection items and use them in your designs. You can use a Multi-image Field to create dynamic image grids and dynamic lightbox galleries.

At the moment, these images can be used as regular image elements, background images or as Lightbox media only within Collection Pages.

You can also use a Multi-image Field to filter a Collection List or set conditional visibility on elements in Collection Lists and pages. Here are some common uses for the Multi-image Field:

  • Photo galleries
  • Product thumbnails
  • Dynamic lightboxes
In this lesson
  1. Create a Multi-image Field
  2. Add images to the Multi-image Field
  3. Use a Multi-image Field in your designs
  4. Filter a Collection List using a Multi-image Field
  5. Set conditional visibility using a Multi-image Field

Create a multi-image field

A Multi-image Field can be added to a new or existing Collection. In Collection settings, click New Field and then choose the Multi-image Field. And as with any field, you can specify if the field is required or not.

Add a Multi-image Field in your Collection settings.

Add images to the Multi-image Field

To upload images into a Multi-image Field, drag and drop them into the field or click to upload them. You can upload any accepted image file type.

The maximum file size for images is 4MB. Responsive variants are created for these images upon upload. However, these variants are used only when the images are used as image elements, not on background images.
Drag and drop your images into the Multi-image Field in any Collection item.

Reorder images uploaded to a Multi-image Field

Once your images are uploaded, you can reorder them by dragging them around within the Multi-image Field. Make sure to save the item to save the new order.

Add more images to a Multi-image Field

You can add more images to a Multi-image Field as long as you haven’t reached the 25 image limit per field.

Set alt text for images in a Multi-image Field

You can specify an alt text for each image in a Multi-image Field. This is important for SEO and accessibility. You can add the alt text for each image from the image menu which you can access by clicking the ellipsis (...) that appears on each image as you hover over it.

Delete images from a Multi-image Field

You can also delete any images from the Multi-image Field from the same menu. Click the ellipsis(...) and choose delete.

Use a Multi-image Field in your designs

You can display the images of a Multi-image Field on its Collection page by adding a Collection List on that page and connecting it to the Multi-image Field.

Next, you can either add image elements, div blocks, or lightboxes to display your images.

Connect the Multi-image Field to image elements

  1. Add a Collection List onto the Collection page
  2. Connect the Collection List to the Multi-image Field
  3. Add an image element in the Collection List
  4. In the Image Settings, choose to get the image from the multi image field
  5. Update the layout of the Collection list to create the design you want

Connect the Multi-image Field to background images

You can set images from the Multi-image Field as the background of an element, like a div block, to crop images and fit them in boxes of specific dimensions or shapes. To set a dynamic background image using the Multi-image Field:

  1. Add a Collection List onto the Collection page
  2. Connect the Collection List to the Multi-image Field
  3. Add a div block in the Collection List
  4. In the Element Settings panel, choose to get the BG image from the Multi-image Field
  5. In the Style panel, add a background image to the div block and adjust the background image settings as you like
  6. In the Style panel as well, set the size of the div block
  7. Update the layout of the Collection list to create the design you want

Troubleshooting: If the background image doesn’t look correct:

  1. Make sure you’ve added and set up a background image on the element
  2. Make sure there are no other background images or gradients set on the element
  3. Make sure the element is getting the image from the Multi-image Field. Check the setting in the Element Settings panel.

Connect the Multi-image Field to a lightbox

You can use the Multi-image Field to create dynamic lightboxes.

  1. Add a Collection List onto the Collection page that contains the Multi-image Field
  2. Connect the Collection List to the Multi-image Field
  3. Add a lightbox component in the Collection List
  4. In the Lightbox settings, choose to get the media from the Multi-image Field
  5. Optional: If you want to link the lightboxes together so a user can flip through all images once the lightbox is open, enable the option in the Lightbox settings and specify a lightbox group name.
  6. Update the layout of the Collection list to create the design you want. Choose either one of the following options to create the gallery:

Option 1: Link the Lightbox image placeholder to the Multi-image Field

Select the image element in the lightbox component and in the Image Settings, choose to get the image from the multi image field.

Option 2: Set a background image on the Lightbox link and get the images from the Multi-image Field

  1. Delete the image element in the lightbox component
  2. Select the lightbox link and in the Element Settings panel, choose to get the BG image from the Multi-image Field
  3. In the Style panel, add a background image to the div block and adjust the background image settings as you like
  4. In the Style panel as well, set the size of the div block

Filter a Collection List using a Multi-image Field

Although you cannot filter a Collection List that is connected to a Multi-image Field, you can filter other Collection Lists to only display items that have a specific Multi-image Field set or not set.

For example, you can create a Collection list of “More photos” where you only show items for which you’ve uploaded images in the Multi-image Field.

 To filter a Collection List based on whether a Multi-image Field is set or not:

  1. Select the Collection List you want to filter
  2. In the Element Settings panel, add a filter under Collection List Settings
  3. Select the relevant Multi-image Field in the first dropdown
  4. Choose “is set” in the second field
  5. Save the filter

The filter rules that you can use with the Multi-image Field are:

  • Is Set - looks for Collection items that have images for this Multi-image Field
  • Is Not Set - looks for Collection items that don’t have images set for this Multi-image Field

Learn more about filtering Collection Lists.

Set conditional visibility using a Multi-image Field

In the same way, you can set a conditional visibility rule on any element in your Collection List or Page. This will ensure that these elements will only be visible when the Multi-image Field is set for a given Collection item. 

You can use this conditional visibility to display a “see photo album” text link in a Collection List. You can also use it to display a heading (eg. “Photo from this trip”) in the section where you display these images on the Collection page.

  1. Select the element you want to display only when a Multi-image Field is set
  2. In the Element Settings panel, add a condition under Conditional Visibility
  3. Select your Multi-image Field in the first dropdown
  4. Choose “Is Set” in the second dropdown
  5. Save the condition

Learn more about conditional visibility.

Best practices for better web page performance

Loading too many images on a page may slow down your page load speed. So, when you’re pulling up 25 multi-images per page, make sure to optimize your images before uploading them to the CMS or paginate the Collection list connected to the Multi-image Field.

Common questions

Why isn't there filtering and sorting options for Collection Lists connected to a multi-image field?

There’s no filtering and sorting options for this Collection List because it automatically shows the images from the connected Multi-image Field in the order that you've added them within the Multi-image Field.

Why can't I show Multi-image Field data in a Collection List connected to the Collection?

At the moment, you can show Multi-image Field values only on a Collection page, and not within a Collection List. Support for nested Collection lists is planned. Vote for and subscribe to status updates of this feature request.



Browser support

Can I Use ? Data on support for the feature across the major browsers from caniuse.com.