Media blocks
In short: Media blocks in the editor: Image, Avatar, Video, galleries, Before / after, Marquee, Icon and Carousel, with every setting.
Media blocks bring pictures, video and motion to a page: a single image, a gallery with a lightbox, a video player, a before-and-after slider, a scrolling strip of words or logos, and a carousel.
Where to find it
Open a page in the editor (Sidebar → STOREFRONT → Pages), then:
- Press Add between or inside sections, choose Component, and look under Text and media.
- Search by name to jump straight to one.
- Double-click an image on the canvas to swap it, or drop a new image file on it ("Drop image to replace").
- See Add a section or a block.
The blocks
| Block | What it puts on the page |
|---|---|
Image | A single image. The workhorse of most storefronts. |
Avatar | A small circular image, for a person — an author, an instructor, a testimonial face. |
VideoEmbedRoot | A video from an external host, embedded in the page. |
ImageGalleryRoot | A group of images shown together as a gallery. Add the images inside it. |
VideoGalleryRoot | Several videos shown together. |
BeforeAfterRoot | Two images with a slider between them. Made for transformations — the strongest proof you can show for a service. |
Marquee | A row of content that scrolls sideways continuously. Eye-catching; tiring if the page has more than one. |
Icon | A single icon, for a feature list or to sit beside a heading. |
Also in this family: Filterable gallery (an image gallery with category chips) and Carousel (swipeable slides), described below. Maps and other embeds are on Contact, map and embed blocks.
Image
| Setting | What it does |
|---|---|
| Image (Pick) | Choose from your media library or paste a link. Replace image on the canvas toolbar swaps it. |
| Alt text | Describes the picture for screen readers and search engines. The Publish check flags images with no description. |
| Aspect ratio | Auto (natural ratio), Square, Portrait, Wide or Original (show the whole image, no crop). |
| Fit | Cover, Contain, Fill, Scale down or None. |
| Focal point | A 3 by 3 grid (Top left to Bottom right) or drag the picture: which part of it stays in view when the frame crops it. "Applies everywhere this photo appears" for product photos. |
| Radius | Corner rounding for this image. |
| Priority (above-the-fold) | Loads the image first. Use it for the big top image. |
| Opacity, Rotation, Scale (X and Y), Lock aspect ratio, Reset transform | Free transforms for placed layers. |
| Image filters | Brightness, Contrast, Saturation, Hue rotate, Blur, Grayscale and presets Original, B&W, Vintage, Bright, Cool, Warm, plus Drop shadow. Reset all clears them. |
| Crop image | Enter crop mode, drag the region and its handles, then apply (or Esc to cancel). |
| Image type presets | Hero, Banner, Thumbnail, Avatar, Product and Gallery fill empty fields with sensible values for that use. |
Avatar
A round portrait with an optional name and role: Photo, Alt text, Name, Role / title, Size, Align, Show name, Show role and a Link. Until a photo is added, No photo shows lets you choose Initials or Icon.
Video
A video player for YouTube, Vimeo, Instagram, TikTok or an uploaded or direct video link.
| Setting | What it does |
|---|---|
| Video URL | Paste a link. Detected provider shows what was recognised; an unrecognised link shows "buyers will see nothing". Portrait providers lock the aspect to 9:16. |
| How it plays | Click to play or Background loop. |
| Sound off at start, Autoplay (muted), Loop, Show controls | Playback behavior. Start at (seconds) begins part-way in. |
| Poster URL | The still shown before play. |
| Aspect, Radius, Size | Shape and size (Auto, Custom, Full width). |
| Closed captions (.vtt) and Caption language | A captions file for the video. |
Video gallery
- Several videos in one block: Layout (Swipe row, Grid · 2 columns, Grid · 3 columns or Theatre · big player + playlist), Corner radius, Show titles, Show captions, Title/caption placement (below the card, overlay at the bottom or top), Aspect ratio, Tile height, and for the row, Arrow position, Arrow shape and Arrow visibility.
- Each video has Video URL, Poster image, Title, Caption, Badge (for example "Behind the scenes"), Link and, in Theatre, Length.
- Silent autoplay loop works for direct video files only.
Image gallery and Filterable gallery
A grid or masonry gallery with a lightbox (arrow keys to move, Esc to close).
- Layout (including a Logo Strip), Aspect ratio (Square, 16 / 9, 4 / 3, 3 / 4, 9 / 16, Auto), Images (Add, Add first image, move up or down, remove; each with Alt text and Caption).
- Lightbox on click opens a fullscreen overlay. On a Logo Strip the shape and lightbox are always off.
- Filterable gallery adds a chip row built from each image's Category (for filter). "All" chip label renames the first chip. No chips show until at least one image has a category.
Before / after
A slider that compares two images: Before image, After image, Before label, After label (defaults "Before" and "After"), Swap before and after, and Initial slider position. It can be horizontal or vertical.
Marquee
A scrolling strip of short words or logos.
| Setting | What it does |
|---|---|
| Items (one per line) | The words. Each item can also be a logo with Logo, Alt text, Link URL (optional) and Logo height (px) (Add a logo). |
| Speed and Direction | How fast it moves and which way. The hint shows about how many pixels a second, the same on a phone and a desktop. |
| Pause on hover / Loop forever / Edge fade / Full width (edge-to-edge) | Behavior and edges. |
| Separator style | Dot, Star, Slash, Hyphen, Dash or Diamond. |
| Emphasis, Tone and Fine tune | Loud banner and colors: Background color, Border color, Separator color, Text color, Text size, Band height (Tight, Normal, Tall) and Letter spacing. |
Icon
- A single icon: Lucide icon name (pick one, or type a name, an emoji or an Iconify id such as
mdi:access-point), Type (Icon or Image, to use your logo or a custom icon in the same size box), Size, Tone, Custom color, Align, Background shape (None, Circle, Square, Rounded, Outline ring, Gradient disc), Link URL and Link label (the name screen readers announce for a linked icon). - With no link the icon is decorative.
Carousel
Swipeable slides for hero features, testimonials or logos with text.
| Setting | What it does |
|---|---|
| Layout and Height | The slide layout and height preset. |
| Slides | Each slide has an image, a heading, a Subheading and Buttons (up to 4). |
| Behavior | Loop slides (circular), Show prev/next arrows, Open link in new tab, Image ratio. |
| Interval | Seconds between automatic slides; Starts on slide. |
| Slide dots | Auto, Show or Hide. |
| Text color, Overlay darkness | Keep text readable over a photo. |
| Arrow position | Middle (split apart), Top left, Top right, Bottom left, Bottom right. |
The section inspector also offers Items visible (how many slides show at once on a desktop; a phone always shows one) and Advance (Manual only or Auto-advance).
Steps: add a gallery
- Press Add where the gallery should go, choose Component, open Text and media and pick Gallery (or search "gallery").
- In the inspector, press Add first image, choose a picture from the media library, and type its Alt text.
- Choose Layout and Aspect ratio. Turn Lightbox on click on if you want buyers to enlarge pictures.
- Switch the canvas to phone with the device buttons and check the tiles.
What happens, and what doesn't
- Images are optimised for you. The Priority (above-the-fold) switch only changes load order.
- A video from a provider shows its own player; Background loop needs a direct video file.
- Alt text matters: images without it are flagged in the Publish checks and skipped by screen readers and search engines.
- Motion (Marquee, Carousel autoplay) respects visitors whose device asks for reduced motion.
Questions
How do I swap an image without losing its settings?
Use Replace image on the canvas toolbar, or double-click the image, or drop a file on it. Its crop, fit and focal point stay.
Why does my video show nothing?
The link was not recognised. Paste a YouTube, Vimeo, Instagram, TikTok or direct video link; the Detected provider line tells you what was recognised.
Can I add captions to a video?
Yes. Upload a .vtt file under Closed captions and choose the Caption language.
How do I show only some images in a gallery?
Use a Filterable gallery and give each image a Category. Visitors then filter by the chips.