- File:
sections/hero-alcove.liquid - Add section category: Banners
- Up to 5 blocks
Section settings
| Setting | Type | Options | Default | Notes |
|---|---|---|---|---|
| Featured product | product | Image, title, vendor and price come from this product. | ||
| Image | image_picker | Overrides the product image. | ||
| Heading | text | Masterworks, ready to hang | ||
| Text | richtext | <p>Museum masterworks, printed to order on archival paper. Free shipping and free returns for 30 days.</p> | ||
| Button label | text | Shop new art | ||
| Button link | url | |||
| Link label | text | Meet the artists | ||
| Link URL | url |
Wall
| Setting | Type | Options | Default | Notes |
|---|---|---|---|---|
| Wall background | select | Solid color, Gradient, Image | Solid color | |
| Wall color | color | #d9d2c5 | Also used behind the slide controls. | |
| Gradient | color_background | linear-gradient(180deg, rgba(217,210,197,1) 0%, rgba(190,181,166,1) 100%) | Shown when section.settings.wall_background == 'gradient'. |
|
| Wall image | image_picker | Shown when section.settings.wall_background == 'image'. |
||
| Image position | select | Top, Center, Bottom | Center | Shown when section.settings.wall_background == 'image'. |
| Show product caption under the image | checkbox | On | ||
| Show slide controls | checkbox | On | A small index in a corner of the wall: arrows, slide numbers and, with autoplay, pause. Visitors can still drag or swipe to change the slide. On phones the arrows are hidden: visitors swipe or tap a slide number. The pause button stays when autoplay is on. | |
| Controls position | select | Bottom right, Bottom left, Top right, Top left | Bottom right | Mirrored for right-to-left languages. Shown when section.settings.show_controls. |
Add to cart
| Setting | Type | Options | Default | Notes |
|---|---|---|---|---|
| Show add to cart | checkbox | Off | A product with options adds its first available option, or the button opens the product page so the visitor can choose. | |
| Button label | text | Leave empty for Add to cart. Shown when section.settings.show_add_to_cart. |
||
| Add to cart style | select | Theme, Solid, Outline, Glass, Soft tint | Theme | Theme follows the primary button style in Theme settings. Shown when section.settings.show_add_to_cart. |
| Open the cart after adding a product | checkbox | Off | Off keeps the hero in view: the product moves to the corner and the next slide shows. Shown when section.settings.show_add_to_cart. |
|
| Show added products in a corner of the wall | checkbox | On | Shown when section.settings.show_add_to_cart. |
|
| Position | select | Top right, Top left, Bottom right, Bottom left | Top right | Mirrored for right-to-left languages. Shown when section.settings.show_add_to_cart and section.settings.show_tray. |
| Size | select | Small, Medium, Large | Medium | Shown when section.settings.show_add_to_cart and section.settings.show_tray. |
| Label | text | In your cart | Shown when section.settings.show_add_to_cart and section.settings.show_tray. |
|
| Alcove style | select | Arch, Oak shelf, Wide recess, Classical niche, Plaster arch, Molded niche | Arch | The shape, light and floor of the recess. In the classical niche, works set to stand on the floor stand on the plinth. |
Mobile
| Setting | Type | Options | Default | Notes |
|---|---|---|---|---|
| Fill the screen on phones | checkbox | Off | The wall color fills the whole screen and the text sits on it. Pick a color scheme whose text reads on the wall color. | |
| Hero ground text position on phones | select | On the floor below the wall, Top of the screen, Just above the product, Just below the product, Bottom of the screen | On the floor below the wall | Shown when section.settings.mobile_full_screen. |
Slideshow
| Setting | Type | Options | Default | Notes |
|---|---|---|---|---|
| Slide animation | select | Swing, Fade, Slide along, Rise, Zoom, Turntable, Curtain | Swing | How one work gives way to the next. Dragging follows the finger in every style. Turntable suits objects such as ceramics. |
| Change slides automatically | checkbox | Off | Pauses while a visitor hovers, touches the section or uses the controls, and for visitors who prefer reduced motion. A pause button sits with the controls. | |
| Time per slide | range | 3 to 12 s, step 1 | 6 s | Shown when section.settings.autoplay. |
Cursor lighting
| Setting | Type | Options | Default | Notes |
|---|---|---|---|---|
| Light the product with the cursor | checkbox | On | A spotlight follows the pointer and the product tilts toward it. On phones it drifts on its own and follows a finger drag. Off for reduced motion. | |
| Tilt | range | 0 to 12 °, step 2 | 6 ° | Shown when section.settings.cursor_effect. |
| Light strength | range | 10 to 100 %, step 10 | 60 % | Shown when section.settings.cursor_effect. |
Visibility
| Setting | Type | Options | Default | Notes |
|---|---|---|---|---|
| Hide when connected data is empty | checkbox | Off | Connect a product metafield below. On a product where it is empty, the section is hidden. | |
| Connected data | text | Use the connect dynamic source button to pick a product metafield. Shown when section.settings.hide_if_empty. |
||
| Color scheme | color_scheme | scheme-9 | ||
| Top padding | range | 0 to 160 px, step 4 | 0 px | |
| Bottom padding | range | 0 to 160 px, step 4 | 0 px |
Custom colors
| Setting | Type | Options | Default | Notes |
|---|---|---|---|---|
| Use custom colors | checkbox | Off | Overrides the color scheme for this section only. | |
| Background | color | #faf6f0 | Shown when section.settings.use_custom_colors. |
|
| Text | color | #2e241b | Shown when section.settings.use_custom_colors. |
|
| Button | color | #2e241b | Shown when section.settings.use_custom_colors. |
|
| Button label | color | #ffffff | Shown when section.settings.use_custom_colors. |
|
| Accent and links | color | #546633 | Keep text and background at a contrast of 4.5 to 1. Shown when section.settings.use_custom_colors. |
Border lines
| Setting | Type | Options | Default | Notes |
|---|---|---|---|---|
| Top border line | checkbox | Off | ||
| Bottom border line | checkbox | Off | ||
| Line thickness | range | 1 to 8 px, step 1 | 1 px | Shown when section.settings.border_top or section.settings.border_bottom. |
| Line color | color | Leave empty to use the theme's line color. Shown when section.settings.border_top or section.settings.border_bottom. |
||
| Line length | select | Full screen width, Page width | Full screen width | Shown when section.settings.border_top or section.settings.border_bottom. |
Blocks
Slide
| Setting | Type | Options | Default | Notes |
|---|---|---|---|---|
| Featured product | product | Image, title, vendor and price come from this product. | ||
| Image | image_picker | Overrides the product image. | ||
| Heading | text | Masterworks, ready to hang | ||
| Text | richtext | <p>Museum masterworks, printed to order on archival paper. Free shipping and free returns for 30 days.</p> | ||
| Button label | text | Shop new art | ||
| Button link | url | |||
| Link label | text | Meet the artists | ||
| Link URL | url | |||
| Wall color | color | Leave empty to use the section wall color. Solid color only. |
Image placement
| Setting | Type | Options | Default | Notes |
|---|---|---|---|---|
| Horizontal position | range | -50 to 50 %, step 1 | 0 % | |
| Vertical position | range | -50 to 50 %, step 1 | 0 % | |
| Image size | range | 20 to 200 %, step 5 | 100 % | |
| Stand on the alcove floor | checkbox | Off | The bottom of the picture rests on the alcove floor at every screen size, and Vertical position nudges it from there. If the cut-out has empty space below the object, add a few %. | |
| Separate placement on phones and tablets | checkbox | Off | Phones and tablets use the mobile position and size below instead of the desktop ones. Check them in the theme editor's mobile view. | |
| Horizontal position (mobile) | range | -50 to 50 %, step 1 | 0 % | Shown when block.settings.art_mobile. |
| Vertical position (mobile) | range | -50 to 50 %, step 1 | 0 % | Shown when block.settings.art_mobile. |
| Image size (mobile) | range | 20 to 200 %, step 5 | 100 % | Shown when block.settings.art_mobile. |
| Shadow | select | Gallery lighting, Soft ambient, Window light, Picture light, Custom, None | Gallery lighting | Shadows fall on the wall behind the work and scale with the wall. Every choice except Gallery lighting keeps the work fixed to the wall. Shown when block.settings.art_floor == false. |
| Floor shadow | select | Gallery lighting, Contact shadow, Soft overhead, Spotlight, Window light, Low sun, Glossy floor, Custom, None | Gallery lighting | Floor shadows suit cut-out products (transparent PNG or WebP) standing on the alcove floor; other pictures cast the shape of their frame. Every choice except Gallery lighting keeps the work fixed. Shown when block.settings.art_floor. |
| Light from | select | Text side, Left, Right | Text side | Text side mirrors for right-to-left languages. Left and Right stay put, for a wall image lit from one side. Shown when block.settings.art_shadow == 'window' or block.settings.art_floor_shadow == 'spot' or block.settings.art_floor_shadow == 'window' or block.settings.art_floor_shadow == 'sunset'. |
| Space below the product | range | 0 to 30 %, step 1 | 0 % | If the cut-out has empty space under the object, raise this until the shadow meets its base. Shown when block.settings.art_floor and block.settings.art_floor_shadow != 'theme' and block.settings.art_floor_shadow != 'custom' and block.settings.art_floor_shadow != 'none'. |
| Shadow horizontal offset | range | -40 to 40 px, step 1 | 0 px | As seen on a 1440 px wide window; scales with the wall. Shown when block.settings.art_shadow == 'custom' or block.settings.art_floor_shadow == 'custom'. |
| Shadow vertical offset | range | -40 to 40 px, step 1 | 12 px | As seen on a 1440 px wide window; scales with the wall. Shown when block.settings.art_shadow == 'custom' or block.settings.art_floor_shadow == 'custom'. |
| Shadow blur | range | 0 to 60 px, step 1 | 16 px | As seen on a 1440 px wide window; scales with the wall. Shown when block.settings.art_shadow == 'custom' or block.settings.art_floor_shadow == 'custom'. |
| Shadow opacity | range | 0 to 100 %, step 5 | 35 % | Shown when block.settings.art_shadow == 'custom' or block.settings.art_floor_shadow == 'custom'. |
| Shadow color | color | #000000 | Shown when block.settings.art_shadow == 'custom' or block.settings.art_floor_shadow == 'custom'. |