Skip to content

Session Modals

Session Modals

Session Modals allow you to display pop-up windows to your players – for example for announcements, notices, or call-to-action buttons.

Create Modal

Content

Configure what is displayed in the modal.

FieldDescription
TitleOptional heading displayed at the top of the modal.
Content (required)The main content of the modal (text, HTML, etc.).
ImageOptional image displayed above the modal content (max 5 MB).

Buttons

You can add any number of buttons to the modal. Each button has the following fields:

FieldDescription
Label (required)The button text.
Style (required)Visual style of the button, e.g. Primary.
URLTarget URL when clicked. Leave empty for a dismiss-only button.

Display Conditions

Define when and to whom this modal is shown.

FieldDescription
Display Frequency (required)How often the modal is shown, e.g. Once per session.
Show to (required)Target audience, e.g. All visitors (guests & logged-in).
Minimum character levelShow only to players whose highest character has at least this level. Leave empty to skip.
Only for players who have not voted todayOnly show the modal to players who have not voted today.
Only for new playersOnly show the modal to new players.
Restrict to pagesLimit display to specific pages. Leave empty to show on all pages. Enter route names (e.g. dashboard, webmall.index).

Scheduling

Optionally limit this modal to a specific time window.

FieldDescription
Start date / timeThe point in time from which the modal is shown.
End date / timeThe point in time after which the modal is no longer shown.

Settings

FieldDescription
ActiveInactive modals are never shown to players.
Allow backdrop click to dismissAllows players to close the modal by clicking the background.
Sort OrderOrder when multiple modals are active. Lower numbers are shown first. Default: 0.

Released under the PolyForm Shield License 1.0.0.