Docs

Layout & appearance

Modal, slide-in, bar or full screen: position, size, animation, overlay and closing.

On this page

A popup's layout decides its shape and place on the screen: a centered modal, a small panel in a corner, a bar along the top or bottom, or a full-screen takeover. You also set its size, colors, entrance animation, the dimmed overlay behind it and how visitors close it.

The Layout, Appearance and Closing groups of the Popup settings drawer
Popup settings → Layout, Appearance and Closing.

These settings are in the Theme Builder's Popup settings drawer and in the Popup tab of the editor (under Appearance and Closing). Both change the same popup.

Choose a layout

LayoutUse it for
ModalA box in the middle of the screen (or at another Position) that asks for attention: a signup, an offer, a confirmation.
Slide-inA smaller panel in a corner or at a side, for example a chat prompt or a discreet offer. Pair it with Overlay off so visitors can keep reading.
BarA full-width strip along the top or bottom of the window, for announcements such as holiday opening hours.
Full screenCovers the whole window, for an important announcement or a focused signup. It has no position or width.
A bar popup along the bottom of the Northwind Studio home page announcing holiday opening hours
A Bar popup at the bottom of the window, without an overlay.

Position, size and animation

Layout
SettingWhat it does
PositionWhere the popup sits: the nine cells of the grid (top left to bottom right). Bars use top or bottom. Not used by Full screen.
WidthIn px, %, vw or rem (560 px by default). Popups never get wider than the screen. Not used by Full screen.
AnimationHow it appears: Zoom (default), Fade, Slide up, Slide down, Slide left, Slide right or None. Visitors who prefer reduced motion always see it without animation.

In the editor's Popup tab the slide animations read Slide from the right and Slide from the left.

Appearance

Appearance
SettingWhat it does
BackgroundBackground color of the popup (white by default).
Corner radiusRounded corners, in pixels (16 by default).
PaddingSpace inside the popup, in pixels (32 by default). Bars use half of it at the top and bottom.
OverlayDims the page behind the popup. With an overlay, the page cannot scroll and keyboard focus stays inside the popup until it closes.
Overlay colorColor and transparency of the overlay.

The content inside the popup (text, images, form) is styled like any other element in the editor. Set the popup's own background to transparent if your content has its own background and shape.

Closing

Closing
SettingWhat it does
Close buttonA round × button in the top right corner.
Close on overlay clickClicking the dimmed page closes the popup. Only with Overlay on.
Close with Esc keyEsc closes the popup.

You can also add your own close button inside the popup: give any button or link the address #urmi-popup:close. See Open from a link. If you turn off every way of closing, make sure the popup's content has such a button.