# Media blocks

> Media blocks in the editor: Image, Avatar, Video, galleries, Before / after, Marquee, Icon and Carousel, with every setting.

Source: https://docs.personacart.com/editor/blocks/media

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.

1. Open a page in the editor, hover inside a section and press **Add**.
2. Choose **Component** and pick the block.
3. Click it on the canvas and change its settings in the inspector on the right.

## 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](/editor/add-section-and-templates).

## The blocks

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](/editor/blocks/contact-and-embeds).

## 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
