The Gallery tab controls the grid itself: how many columns, how many posts load, how videos behave and how posts are sorted. Each option below lists what it does, the accepted values exactly as they appear in the editor, and the default. Values come straight from the layout config, so this is the real set, not a paraphrase.
Grid shape
- Columns — desktop column count for the grid. Default 4.
- Columns (Mobile) — column count on phones and small screens. Default 1.5 (a half-column hint shows the next post is swipeable).
- Posts Per Page — how many posts load or display per page. A range from 4 to 48 in steps of 4. Default 14.
- Pagination — how more posts load. Accepted values: None (none), Page Nos. (pageNumbers), Load More (loadMore), Auto Scroll (autoScroll). Default Auto Scroll.
- Post Spacing — the gap between posts. Default 10.
Sorting
- Sort by — what to order posts on. Accepted values: Engagement (engagement) or Date (date). Default Engagement.
- Sort Order — direction. Accepted values: Ascending (1) or Descending (-1). Default Descending.
Video settings (on the Gallery tab)
Autoplay and hover behaviour
- Video Autoplay — play videos automatically as they appear. Default off.
- Play on Hover — when autoplay is off, videos play on hover. Best paired with Video Autoplay off. Default off.
- Show Play Button — show a play-icon overlay on video thumbnails. Default on.
- Disable Auto-Play Next — stop automatic progression to the next video when one ends. Default off.
- Enable Swipe More (Mobile Modal) — allow swiping through posts in the mobile modal. Default on.
- Play All Visible Videos — autoplay every visible slide at once (Special Carousel only). Default off.
Playback speed and frequency
- Video Auto Play Frequency — Play once (one) or Play all (All). Default Play once.
- Enable Video Speed Control — let the widget apply the custom speeds below; when off, videos play at the browser default. Default off.
- Video Speed — Main Screen and Video Speed — Modal — playback speed for inline and popup video. Default 1 for both.
On-widget filters (Gallery tab)
The Gallery tab also holds the shopper-facing filter toggles (distinct from the content-selection filters on the Filters & Sorting tab):
- Product Filter — add a menu so shoppers filter posts by tagged product. Default off.
- Category Filter — add a dropdown/tabs to filter by post category. Default off.
- Attribute Filter — a Pinterest-style chip strip to filter by a custom attribute (Shade, Size, Color). Default off; the label defaults to “Shade”.
