modal-usage
When to use
- Promotional popups — show offers or announcements on page load with a delay. Use sparingly.
- Content lightboxes — open detailed content, images, or videos from a click trigger without leaving the page.
- Exit intent — last-chance offers when user moves to leave. Use for retention.
- Confirmations — important actions that need user acknowledgment before proceeding.
Key decisions
- Trigger: modal-trigger-click for user-initiated, modal-trigger-pageload for promotional (with delay), modal-trigger-exit-intent for retention.
- Size: modal-size-medium for standard content, modal-size-large for images/video, modal-size-fullscreen for immersive experiences.
- Close behavior: modal-close-both is most user-friendly. Avoid removing close options.
- Animation: modal-animation-fade for subtle, modal-animation-slide-up for mobile-friendly.
modal-options
All authoring options
Section decorator
filter: modal
model: modal
name: display name
Behavior
classes_modalTrigger: modal-trigger-click | modal-trigger-pageload | modal-trigger-exit-intent
classes_modalClose: modal-close-button | modal-close-backdrop | modal-close-both
classes_modalDelay: delay before auto-show (page-load trigger)
Appearance
classes_modalSize: modal-size-small | modal-size-medium | modal-size-large | modal-size-fullscreen
classes_modalAnimation: modal-animation-fade | modal-animation-slide-up | modal-animation-scale
classes_modalPosition: modal-position-center | modal-position-top | modal-position-bottom
Analytics
trackInview: boolean
trackInviewMeta: text