Docs

Alert

A notice for info, success, warning or danger, with an optional dismiss button.

On this page

The Alert widget highlights a short message: holiday hours, a booking confirmation, a delivery delay or an important warning. Each type has its own icon and color, and visitors can close the alert. With Remember dismissal, it stays closed for them on later visits.

Three alerts: an info alert about holiday hours with a close button, a success alert with a side accent and an outlined warning alert
Info (Soft), success (Soft with side accent) and warning (Outline) alerts.

Add an alert

  1. Insert it

    Open Insert in the left panel, find Alert under Basic (or type alert in Search widgets) and click it or drag it onto the canvas.

  2. Write the message

    Type the Title and Description in Content → Alert, or double-click the text on the canvas to edit it there.

  3. Choose the type and style

    Pick a Type (Info, Success, Warning or Danger) and a Style. The type sets the icon and color; change the color with Design → Box → Accent color.

  4. Decide how it closes

    Keep Dismiss button on to let visitors close it. Turn on Remember dismissal to keep it closed for them.

Show a dismissed alert again

A remembered dismissal is stored in the visitor's browser under the Storage key. When the message changes, for example next year's holiday dates, type a new Storage key (such as holiday-notice-2027) and every visitor sees the alert again.

Settings

Settings marked Per device can differ on desktop, tablet and mobile (see Responsive editing). Fields that support dynamic tags can show data such as the post title (see Dynamic tags).

Content tab

Alert
SettingWhat it does
TypeThe kind of message. It sets the default icon and color. Options: Info, Success, Warning, Danger. Default: Info.
StyleThe look: a tinted box, a tinted box with a colored side line, an outline, or a solid colored box. Options: Soft, Soft with side accent, Outline, Solid. Default: Soft.
TitleThe bold first line. Leave it empty for a one-line alert. Supports dynamic tags.
DescriptionThe message under the title. Bold, italic and links are allowed. Supports dynamic tags.
Show iconShows an icon at the start of the alert. On by default.
IconReplaces the icon of the alert type. Leave empty to keep it. Shown when Show icon is on.
Dismiss buttonAdds a close button so visitors can hide the alert. On by default.
Remember dismissalKeeps the alert hidden for this visitor after they close it (remembered in their browser). Shown when Dismiss button is on.
Storage keyA name for the remembered choice. Change it to show the alert again to everyone, for example when the message changes. Defaults to the element ID. Shown when Dismiss button is on and Remember dismissal is on.

Design tab

Box
SettingWhat it does
Accent colorThe main color of the alert: it drives the icon, the border and the tinted background.
Background colorBackground color of the alert box, when it should differ from the tint.
BorderBorder style, width and color of the box.
Side accent widthWidth of the colored side line. Shown when Style is Soft with side accent. Per device.
Border radiusRounds the corners of the box. Per device.
PaddingSpace inside the box. Per device.
ShadowShadow of the box.
Icon

This section shows when Show icon is on.

SettingWhat it does
ColorColor of the icon.
SizeSize of the icon. Per device.
SpacingSpace between the icon and the text. Per device.
Content
SettingWhat it does
Title typographyText style (from the Design System) or font, size, weight, line height and spacing of the title.
Title colorColor of the title.
Title spacingSpace between the title and the description. Per device.
Description typographyText style (from the Design System) or font, size, weight, line height and spacing of the description.
Description colorColor of the description.
Dismiss button

This section shows when Dismiss button is on.

SettingWhat it does
SizeSize of the dismiss button. Per device.
Normal › ColorColor of the dismiss button.
Hover › ColorColor of the dismiss button on hover.
Hover › BackgroundBackground color of the dismiss button on hover.
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

  • Keep it short. A title of a few words and one or two sentences read best.
  • Don't rely on color alone. The icon and the words should say what kind of message it is, for visitors who cannot tell the colors apart.
  • Time-limited notices. Use Behaviour → Conditions with a date range to show an alert only during a period, such as the weeks before a holiday. See Display conditions.
  • Site-wide banners. For a notice on every page, put the alert in your header template or use a bar popup.