Docs

Slides

A full-width hero slider with its own content on each slide.

On this page

The Slides widget is a hero slider: each slide has its own background image, overlay, heading, description and up to two buttons, and slides change by sliding or fading. It is built for the top of a homepage or a promo area. For slides that hold other widgets, use the Carousel instead.

A slide with a dark green room photo, the heading “Calm, lived-in interiors”, a short description, a Book a consultation button and a See our work button, with arrows at the sides and three dots below
The first of three slides, with two buttons, arrows and dots.

Add a slider

  1. Insert it

    Open Insert in the left panel, find Slides under Media (or type slides in Search widgets) and click it or drag it onto the canvas. It starts with three slides.

  2. Fill each slide

    In Content → Slides, click a slide and choose its Background image, type the Heading and Description, and set the Button text and Button link. Add a Second button text for a second button.

  3. Keep the text readable

    Give each slide an Overlay color and Overlay opacity, or set one Overlay for all slides on the Design tab.

  4. Set height and behaviour

    In Content → Layout, set the Height; in Content → Slider, choose the Transition, arrows, pagination and autoplay.

Settings

Settings marked Per device can differ on desktop, tablet and mobile (see Responsive editing).

Content tab

Slides
SettingWhat it does
SlidesThe slides. Add item, drag to reorder, Duplicate item and Delete item.
Each slide
SettingWhat it does
Background imageThe background photo of the slide. The first slide’s image loads first; the others load when needed.
Background colorA color behind the image, or instead of it.
Ken Burns effectA slow zoom on the image while the slide shows. Options: None, Zoom in, Zoom out.
HeadingThe large title of the slide.
DescriptionA short sentence under the heading.
Button textText of the main button. Leave empty for no button.
Button linkWhere the main button goes.
Whole slide clickableMakes the whole slide open the button link. Shown when Button link has a URL.
Second button textText of a second button. Leave empty for none.
Second button linkWhere the second button goes. Shown when Second button text is set.
This slide › Horizontal positionHorizontal position of this slide’s text, instead of the default. Options: Default, Left, Center, Right.
This slide › Vertical positionVertical position of this slide’s text, instead of the default. Options: Default, Top, Middle, Bottom.
This slide › Text alignmentText alignment on this slide, instead of the default. Options: Default, Left, Center, Right.
This slide › Text colorText color on this slide.
This slide › Overlay colorA color over this slide’s image, to keep the text readable.
This slide › Overlay opacityOpacity of that overlay, from 0 to 1.
Layout
SettingWhat it does
HeightMinimum height of the slider. A slide whose content needs more room grows, and all slides stay the same height. Per device.
Content max widthMaximum width of the text block. Per device.
Horizontal positionHorizontal position of the text on every slide. Options: Left, Center, Right. Per device.
Vertical positionVertical position of the text on every slide. Options: Top, Middle, Bottom. Per device.
Text alignmentText alignment on every slide. Options: Left, Center, Right. Per device.
Heading HTML tagThe HTML tag of the slide headings. Use H1 only when the slider is the page’s main title. Default: H2.
Image resolutionThe largest image file offered; browsers pick a smaller one on small screens. Default: Full.
First image loadingAuto loads the first image right away, with high priority, when the slider is in the page’s first section. Right away (hero) always does; Lazy never does. Other slides always load lazily. Options: Auto, Right away (hero), Lazy.
Slider
SettingWhat it does
TransitionHow slides change: sliding or fading. Options: Slide, Fade. Default: Slide.
Transition duration (ms)How long the change takes, in milliseconds. Default: 700.
Content animationAn animation of the text when a new slide comes in. Options: None, Fade in, Fade up, Fade down, Zoom in. Default: Fade up.
Infinite loopNext on the last slide shows the first one. On by default.
Swipe and dragChanges slides with a touch swipe or a mouse drag. On by default.
Navigation › ArrowsShows previous and next buttons. On by default.
Navigation › Previous iconIcon of the previous button. Shown when Arrows is on.
Navigation › Next iconIcon of the next button. Shown when Arrows is on.
Navigation › PaginationDots, a “2 / 5” counter or nothing. Options: None, Dots, Fraction (2 / 5). Default: Dots.
Autoplay › AutoplayMoves to the next slide on its own. It never starts in the editor or for visitors who prefer reduced motion, and it pauses while hovered, focused or off screen. On by default.
Autoplay › Delay (ms)Time each slide stays, in milliseconds. Default: 6000. Shown when Autoplay is on.
Autoplay › Pause on hoverStops autoplay while the pointer is over the slider. On by default. Shown when Autoplay is on.
Autoplay › Pause buttonAdds a pause/play button. Required by WCAG 2.2.2 for content that moves on its own. On by default. Shown when Autoplay is on.
Autoplay › Accessible nameName of the slider for screen readers, for example “Featured projects”.

Design tab

Slides
SettingWhat it does
Background colorBackground color of every slide; a slide’s own color wins.
Text colorText color on every slide.
Content paddingSpace around the text block. Per device.
Border radiusRounds the corners of the slider. Per device.
Image focal pointWhich part of the images stays visible when they are cropped.
Ken Burns zoomHow far the Ken Burns effect zooms, for example 1.15.
Image filtersBlur, brightness, contrast, saturation and hue of the images.
Overlay
SettingWhat it does
OverlayA color, gradient or image over every slide, to keep the text readable.
OpacityOpacity of the overlay, from 0 to 1.
Heading
SettingWhat it does
TypographyText style or font, size, weight and spacing of the headings.
ColorColor of the headings.
Spacing belowSpace under the headings. Per device.
Text shadowShadow behind the headings.
Description
SettingWhat it does
TypographyText style or font, size, weight and spacing of the descriptions.
ColorColor of the descriptions.
Spacing belowSpace under the descriptions. Per device.
Buttons
SettingWhat it does
Button styleButton style of the main button, from the Design System. Options: Primary, Secondary, Outline, Ghost. Default: Primary.
Second button styleButton style of the second button. Options: Primary, Secondary, Outline, Ghost. Default: Outline.
Button sizeSize of the buttons. Options: S, M, L, XL. Default: L.
Gap between buttonsSpace between the two buttons. Per device.
TypographyText style or font, size, weight and spacing of the buttons.
Border radiusRounds the corners of the buttons. Per device.
Normal › Main button › Text colorText color of the main button.
Normal › Main button › BackgroundBackground color of the main button.
Normal › Main button › Border colorBorder color of the main button.
Hover › Main button › Text colorText color of the main button on hover.
Hover › Main button › BackgroundBackground color of the main button on hover.
Hover › Main button › Border colorBorder color of the main button on hover.
Normal › Second button › Text colorText color of the second button.
Normal › Second button › BackgroundBackground color of the second button.
Normal › Second button › Border colorBorder color of the second button.
Hover › Second button › Text colorText color of the second button on hover.
Hover › Second button › BackgroundBackground color of the second button on hover.
Hover › Second button › Border colorBorder color of the second button on hover.
Arrows

This section shows when Arrows is on.

SettingWhat it does
Button sizeWidth and height of the arrow buttons. Per device.
Icon sizeSize of the arrow icons. Per device.
Distance from edgeDistance of the arrows from the edges of the slider. Per device.
Normal › Icon colorColor of the arrow icons.
Normal › BackgroundBackground color of the arrow buttons.
Normal › Border colorBorder color of the arrow buttons.
Hover › Icon colorColor of the arrow icons on hover.
Hover › BackgroundBackground color of the arrow buttons on hover.
Border radiusRounds the corners of the arrow buttons. Per device.
Pagination & pause button
SettingWhat it does
Distance from bottomDistance of the dots or counter from the bottom. Per device.
Dot sizeSize of the dots. Shown when Pagination is Dots.
Active dot widthWidth of the current dot. Same as the dot size for round dots, wider for a pill. Shown when Pagination is Dots.
Space between dotsSpace between the dots. Shown when Pagination is Dots.
Dot colorColor of the dots. Shown when Pagination is Dots.
Active dot colorColor of the current dot. Shown when Pagination is Dots.
TypographyText style of the “2 / 5” counter. Shown when Pagination is Fraction (2 / 5).
ColorColor of the “2 / 5” counter. Shown when Pagination is Fraction (2 / 5).
Pause button colorColor of the pause/play button. Shown when Autoplay is on.
Shared Design sections

Every element also has these sections at the end of the Design tab.

SectionWhat it does
Spacing & positionMargin, padding, width, alignment in its container, order, position (relative, absolute, fixed), offsets, z-index and global classes. See Spacing, size & position.
Background & borderBackground, border, border radius, box shadow, overflow and opacity of the whole element. See Colors & backgrounds and Borders & shadows.
MaskCrops the element to a shape (circle, arch, blob, star…) or your own SVG or PNG. See Shape dividers & masks.

Behaviour tab

Behaviour sections

The Behaviour tab is the same for every element.

SectionWhat it does
Anchor & classesAn Anchor ID for #links and your own CSS classes.
AnimationsEntrance, scroll, hover and loop animations from presets or your own timeline. See Motion & effects.
Motion & effectsA simple entrance animation, transforms (also on hover), CSS and backdrop filters, and sticky positioning.
Scroll & mouse effectsMovement, rotation, scale, fade and blur while the page scrolls, and pointer effects (follow the pointer, 3D tilt).
VisibilityHide the element on desktop, tablet or mobile, or in dark or light mode. See Visibility.
ConditionsShow the element only when rules match, such as logged-in visitors, a date range or a URL parameter. See Display conditions.
InteractionsShow, hide or change other elements when this one is clicked, hovered or scrolled into view. See Interactions.
AttributesCustom HTML attributes for this element. See Anchor, classes & attributes.

Tips

  • Fast first slide. The first slide's image is a real responsive image that loads first (with high priority when the slider is in the first section); the other slides load lazily. Leave First image loading on Auto.
  • One H1. Set Heading HTML tag to H1 only when the slider is the page's main title, otherwise keep H2.
  • Autoplay and accessibility. Autoplay never runs in the editor or for visitors who prefer reduced motion, and it pauses on hover, focus or when the slider is off screen. Keep the Pause button when autoplay is on.
  • Few slides. Most visitors see only the first slide. Put your main message there and keep it to three to five slides.
  • Keyboard. Visitors can change slides with the arrow keys, Home and End on the slider's controls, and swipe on touch screens.