Column Settings
How to use the Column Settings block in the Meditative Folks Theme.
Column Settings
At a glance
Controls how many images appear per row, spacing between images, and optional horizontal scroll with content peek. Used inside the Image gallery section (one block per section).
Used in
- Image gallery section — add or select the Column Settings block in the section block list.
Settings
Layout
| Setting | What it does | Default | Shows when |
|---|---|---|---|
| Columns (mobile) | Number of columns on mobile when horizontal scroll is off. | 2 | Horizontal scroll is off |
| Columns (tablet) | Columns on tablet when horizontal scroll is off. | 3 | Horizontal scroll is off |
| Columns (desktop) | Columns on desktop when horizontal scroll is off. | 4 | Horizontal scroll is off |
| Grid gap | Space between images. | 10 | Always |
| Enable horizontal scroll | Swipe through images at all screen sizes. | No | Always |
| Visible items (mobile) | Items visible on mobile when scrolling; decimals show a peek of the next image. | 1.2 | Horizontal scroll is on |
| How many items? | Max cards in the swipe track on mobile. None shows every item. | None | Horizontal scroll is on |
| Visible items (tablet) | Same on tablet. | 2.2 | Horizontal scroll is on |
| How many items? | Max cards in the swipe track on tablet. | None | Horizontal scroll is on |
| Visible items (desktop) | Same on desktop. | 3.2 | Horizontal scroll is on |
| How many items? | Max cards in the swipe track on desktop. | None | Horizontal scroll is on |
| Show swipe hint | Helper text below the gallery on mobile. | Yes | Horizontal scroll is on |
Setting details
Columns (mobile)
Number of columns on mobile when horizontal scroll is off. Default: 2.
Columns (tablet)
Columns on tablet when horizontal scroll is off. Default: 3.
Columns (desktop)
Columns on desktop when horizontal scroll is off. Default: 4.
Grid gap
Space between images in pixels. Default: 10.
Enable horizontal scroll
When on, images scroll horizontally at all screen sizes instead of a static grid. Default: No.
Visible items (mobile)
How many items fit in the scroll area on mobile. Use a decimal (for example 1.2) to show a peek of the next image. Default: 1.2.
How many items? (mobile / tablet / desktop)
When horizontal scroll is on, the maximum number of images in the track at that breakpoint. None shows every image (same as before this setting existed). 5, 10, 15, and 20 hide extra images so the carousel stays smaller. Default: None.
Visible items (tablet)
Same for tablet. Default: 2.2.
Visible items (desktop)
Same for desktop. Default: 3.2.
Show swipe hint
Displays swipe helper text below the gallery on mobile. Default: Yes.
Tips
- Add one Column Settings block per Image gallery section (limit 1).
- Turn on horizontal scroll for lookbooks where shoppers should swipe; use whole-number visible items for no peek.