Show photos and videos in a slideshow or a swipeable row, with arrows, dots or previews. Videos can come from a YouTube link, your own file or a table.
The Carousel block shows a set of photos, videos or both that visitors swipe or step through. Use it for a gallery of your work, a row of product shots, a set of trip photos or a handful of customer videos. You pick them from your media library (or paste a YouTube link), and the block does the layout. It used to be called Photo carousel.
Add a carousel
- Open your site in the editor and open the page you want.
- Click the add (plus) button to open the block menu, then pick Carousel in the Media group. You can also type "carousel", "slider", "video carousel" or "gallery" in the search box at the top of the menu.
- Click Add photos or Add videos on the new block.
- Tick one item or several, then confirm. Everything you picked is added in one go.
A carousel with nothing in it shows a placeholder in the editor and nothing on your published page, so an empty one never leaves a gap.
Add, reorder and remove photos and videos
Select the carousel and look at the Photos list (it is called Slides once a video is in it) in the settings panel.
- Add photos and Add videos open your media library. You can pick several at once. While the carousel is selected, both buttons also sit on the block itself.
- Add a YouTube link adds an empty video slide and opens it so you can paste the link.
- Reorder: drag a slide by its handle, or focus the handle and use the keyboard. Photos and videos can be mixed in any order.
- Remove photo or Remove video: the bin button on a row. Undo brings it back.
- Open photo or Open video: the arrow on a row opens that slide's fields.
Description, caption and link for a photo
Open a photo's row to set these:
- Description (for screen readers and Google): say what the photo shows, for example "A diver with a torch on a coral wall". Visitors who cannot see the photo hear it, and search engines use it.
- Just decoration: tick this for a photo that adds nothing to the meaning of the page. The description is cleared and the photo is hidden from screen readers.
- Caption (optional, shown under the photo): a short line under the photo. Leave it empty and no caption is shown.
- Link (optional): a page or address that opens when a visitor clicks the photo.
- Change photo: swaps the picture and keeps the description you typed. If the description was empty, the one from your media library fills it in.
A photo with no description shows No description in the list. After you publish, the message tells you how many carousel photos still need one. It never stops you from publishing.
Add a video
Open a video's row. Under Source, choose:
- Upload: pick an MP4 or WebM file from your media library. Files up to 50 MB work, and under 10 MB loads fastest. A phone video saved as .mov cannot be used: export it as MP4 first.
- YouTube: paste the link. The panel says "YouTube video found." when it works. Only YouTube links and your own files work. Links from other video sites do not.
- From a table: see "Videos from a table" below.
Then fill in the rest:
- Cover image: shown before the video plays. For a YouTube video, leave it empty and the carousel uses YouTube's own preview picture.
- Title (optional, shown with the video): a short line shown with the video.
- Description (for screen readers): one sentence about what the video shows. A video with no description shows No description in the list.
The first video you add to an empty carousel also sets the shape to Wide 16:9 and names the carousel "Videos" for screen readers. You can change both.
How videos behave on your published page:
- A YouTube video is not loaded until a visitor presses play, so your page stays fast.
- Only one video plays at a time, on the whole page. Starting a video stops any other one, even in another carousel or Video block. Moving on to another slide also stops it.
- A carousel with a video never moves by itself, so a video is never taken away from a visitor mid-play. Move on by itself is switched off and says so.
- Photos and videos are called "slides" for screen readers once a video is in the carousel. A video slide ignores a link.
Slideshow or Carousel
Under Layout, choose how the slides show:
- Slideshow: one slide at a time, as wide as the block.
- Carousel: a row of slides. Choose Photos per view, desktop (2, 3 or 4) and Photos per view, phone (1 or 2). Show part of the next photo on phones lets a slice of the next one peek in so visitors can tell there is more. Show part of the next one on computers does the same on larger screens. Gap sets the space between slides: None, S, M or L.
Under Shape, Photo shape sets the same proportions for every slide (Portrait 4:5, Square 1:1, Landscape 3:2, Wide 16:9, or As uploaded). Rounded corners can be None, Small or Large.
Titles sit puts each title Below the picture or On the picture, on a dark fade at the bottom. An on-the-picture title hides while its video plays.
To change the look of the caption or the arrows, select that part and use the Style panel, the same as any other block.
Heading
Heading (optional) puts a title above the slides, such as "Watch our customers". It is only shown when at least one slide is shown, so it never sits alone above nothing.
Arrows, dots, previews and the count
- Arrows step one view at a time. You can put them On the photo or Below. On phones they always sit below.
- Dots show one dot for each stop. With more than 8 stops, the dots become a count such as 4 / 14.
- Previews show a row of small pictures under the slides instead of dots. Videos get a small play mark. Visitors press a picture to go to that slide, and the current one is outlined. Turning Previews on switches the dots off.
- With one slide, or when every slide fits in one view, the arrows and dots are hidden.
- Visitors can also swipe on a phone, scroll sideways, or use the left and right arrow keys.
Move on by itself
Under Movement, Move on by itself can be Off, 3 s, 5 s or 8 s. It is only for carousels of photos: once a video is in the carousel it stays off.
- A pause button is added to the carousel, so visitors can stop it.
- It stops while a visitor points at it or uses it.
- It never moves for visitors whose device is set to reduce motion.
- Start again after the last photo decides whether it goes back to the first one or stops at the end.
Videos from a table
If a page design shows one row of a table at a time, such as one film or one trip per page, each video slide can take its video from that row.
- Open the page design for your table and add a Carousel.
- Add a video slide, open it, and under Source choose From a table. This choice only appears on a page design for a table that has a video file, a link or a text field.
- Under Video from, pick the field that holds the video. It can be a file field or a field that holds a link.
- Under Title from, pick the field for the title, or leave No title.
Each row then shows its own video. A row with nothing in the video field leaves that slide out, and if every slide is left out, the carousel and its heading are left out too.
A few limits. You pick the table fields yourself, one video slide for each field. A table cannot yet fill a whole carousel with a list of videos. Photos cannot come from a table in this block.
Common questions
Can visitors open a photo full screen? Not in this block. If you want a bigger view, add a Link to the photo and point it at a page or the full-size image.
Can the photos come from a table? Not in the carousel. You pick its photos yourself. Videos can come from a table, one slide for each field you choose. To show each row's photos from a table in a grid, use the Gallery block instead: see Add a photo gallery.
Can I use a Vimeo video? Not yet. Use a YouTube link or upload an MP4 or WebM file. For a single video outside a carousel, see Add a video.
What does the "no description" message after publishing mean? Some carousel photos have an empty description. Open the carousel, open each photo marked No description, and type a short sentence, or tick Just decoration if the photo is only for looks. Then publish again.
Can I use more than one carousel on a page? Yes. Each carousel keeps its own slides and settings.