Media gallery

sections/media-gallery.liquid

Settings

Setting	ID	Type	Default	Notes
Heading
Heading	heading	Text	Made with [care]	Wrap words in square brackets to highlight them, e.g. Made with [care].
Highlight style	marker	Dropdown	underline	Options: None, Underline, Filled highlight, Accent color, Italic.
Heading size	heading_size	Dropdown	medium	Options: Small, Medium, Large.
Heading tag	heading_tag	Dropdown	h2	Use H2 unless this section follows another heading. Pages should have only one H1. Options: H2, H3, Paragraph (no heading).
Heading alignment	heading_alignment	Dropdown	center	Options: Left, Center, Right.
Subheading	subheading	Text
Intro text	text	Rich text
Style
Color scheme	surface	Dropdown	background	Options: Background, Surface, Primary, Accent.
Rounded tile corners	rounded	On/off	On	Uses the card corner radius from Theme settings.
Show divider above section	show_divider	On/off	Off
Desktop layout
Number of columns	columns_desktop	Slider	3	Range: 2–6 step 1.
Space between tiles	gap_desktop	Slider	12	Range: 0–40 step 2.
Row height	row_height	Slider	400	Range: 200–700 step 10.
Keep tile proportions on all screens	keep_ratio	On/off	Off	Tiles size themselves from their column and row span. Row height is ignored when this is on.
Make section full width	full_width	On/off	Off
Enable side padding	side_padding	On/off	On	Adds left and right padding when the section is full width.
Top padding	padding_top	Slider	48	Range: 0–120 step 4.
Bottom padding	padding_bottom	Slider	48	Range: 0–120 step 4.
Mobile layout
Swipe carousel on mobile	mobile_carousel	On/off	Off	Tiles scroll sideways instead of stacking. Column and row spans are ignored.
Number of columns	columns_mobile	Dropdown	1	Options: 1, 2.
Space between tiles	gap_mobile	Slider	10	Range: 0–24 step 2.
Row height	row_height_mobile	Slider	250	Range: 150–500 step 10.
Top padding	padding_top_mobile	Slider	32	Range: 0–120 step 4.
Bottom padding	padding_bottom_mobile	Slider	32	Range: 0–120 step 4.

Blocks

Media (media)

Setting	ID	Type	Default	Notes
Media
Image	image	Image
Mobile image	image_mobile	Image		Falls back to the image above.
Video	video	Video (Shopify-hosted)		Overrides the image. Use the image above as the poster frame.
Or embed from URL	video_url	Video URL (YouTube/Vimeo)		Used only when no video is selected above.
Autoplay video	autoplay	On/off	On	Autoplaying video is always muted, as browsers require.
Show sound control	show_sound_control	On/off	Off	Applies to autoplaying Shopify-hosted video only.
Video description	video_alt	Text		Describes the video for screen readers. Leave empty for purely decorative video.
Tile size
Columns wide	column_span	Dropdown	1	Ignored in the mobile carousel. Options: 1, 2, 3.
Rows tall	row_span	Dropdown	1	Options: 1, 2, 3.
Content
Content placement	content_layout	Dropdown	overlay	Options: Over the media, Below the media, Above the media.
Position over media	overlay_position	Dropdown	bottom	Only applies when content sits over the media. Options: Top, Center, Bottom.
Content alignment	content_alignment	Dropdown	left	Options: Left, Center, Right.
Icon	icon	Dropdown	none	Options: None, Leaf, Flower, Water, Feather, Sun, Moon, Heart, Star, Award, Medal, Shield, Earth, Yoga, DNA, Gift, Delivery, Package, Play.
Icon size	icon_size	Slider	32	Range: 16–72 step 4.
Subtitle	subtitle	Text
Title	title	Text	Media heading	Wrap words in square brackets to highlight them.
Title size	title_size	Dropdown	medium	Options: Small, Medium, Large.
Text	text	Rich text
Link
Tile link	link	Link		Makes the whole tile clickable. Needs a title to be accessible.
Button label	button_label	Text
Button link	button_link	Link
Button style	button_style	Dropdown	secondary	Options: Primary, Secondary, Text.
Open links in a new window	link_new_tab	On/off	Off
Colors
Overlay color	overlay_color	Color	#000000
Overlay opacity	overlay_opacity	Slider	35	Darkens the media so overlaid text stays readable. Range: 0–90 step 5.
Overlay text color	text_color	Color	#FFFFFF

Maximum blocks: 12

Presets

Available in Add section: Media gallery