Built on WIX Headless

Docs Widgets Media Gallery widget

Media Gallery widget

Display Media Gallery or image fields as grid, masonry, collage, slider, and more — find every setting in the Media Gallery panel.

Panel map
Media GallerySettings

Gallery or media field mode

  • Data source / Data source mode
  • Gallery or Media field
  • Items to load / Sort

The Media Gallery widget turns Media Gallery fields — or images/videos across items — into rich gallery layouts (grid, masonry, collage, slider, and more). Visitors can search and filter, open a lightbox, go to an item page, or checkout when payments are enabled.

The app binds data to this widget — not to native Harmony Image or gallery elements. Forms can upload into Media Gallery fields; Repeater and Dynamic Page can show gallery fields inline with Field formatting.

Use case examples

  • Architecture portfolio — Masonry of project photos; click through to a Dynamic Page case study.
  • Product lookbook — Filterable collage with lightbox and Buy now in the lightbox (Pro).
  • Agency case studies — Slider of cover images with search by tag.

Build with AI: Open AI setup at the top of the panel and describe layout and click behavior — then refine in Manual. Details: AI setup.

  1. Add Media Gallery from Add → Elements → Installed Apps → CMS for Harmony.
  2. Select the widget → open Settings.
  3. In Content, connect a data source and choose gallery or media fields.
  4. Optionally configure Search & filters, Data refresh, Dynamic page, Payments, Layout, Design, and Mobile.
  5. Publish the site.

Content

Where: Manual overview → Content drill row

Where: Settings → Content

  1. Set Data source to Wix CMS or External Database (see External databases).
  2. Choose gallery mode: a Gallery field on each item, or a Media field across items.
  3. Set Items to load, Max media, Sort by, and Sort order.

Search & filters

Where: Manual overview → Search, filters, & sort drill row

Where: Settings → Search & filters

Full reference: Search & filters.

Data refresh

Where: Settings → Data refresh

Full reference: Data refresh.

Dynamic page

Where: Manual overview — toggle Dynamic page, then open the row (Wix CMS only)

Where: Settings → Dynamic page (Wix CMS only)

  1. Set When image is clicked (lightbox, item page, or related action).
  2. Match Page path and Page link field when linking to a Dynamic Page.
  3. Set Video playback: modal, play on click, or muted autoplay (images still follow the click action you set).

Overview: Dynamic pages.

Payments

Where: Settings → Payments (Pro)

Show Add to cart / Buy now in the lightbox when the collection has catalog payments enabled.

Layout

Where: Settings → Layout

  1. Pick a Layout: grid, masonry, collage, slider, slideshow, strip, or column.
  2. Adjust Columns, Gap, Image aspect, Fit, and Corner radius.
  3. For slider-style layouts, set thumbnail placement, visible slides, and autoplay interval as needed.

Design

Where: Settings → Design

Set Background.

Mobile

Where: Settings → Mobile

  1. Set On small screens and optional Mobile columns.
  2. Set the Breakpoint (320–1200 px).