About presenting studies

The SDK shows a hosted study to the current user inside a widget shell. You can present a specific study yourself, or let audience targeting decide which study to launch. This page explains the concepts; each platform page shows the exact methods and options.

​

Two ways to present

With launch studies, you call the “present if available” method at safe moments (after your main view mounts, on route changes), and the SDK presents the study the backend assigned, or does nothing if none is pending.

​

Presentation modes

A study can appear in three layouts:

• Modal: a centered dialog over a full-page backdrop, dismissed by the backdrop or Escape.
• Overlay: a floating panel anchored to a corner, dismissed by its close button or Escape.
• Embed: inline inside a container element you choose; it fills that container with no backdrop.

Each platform exposes options for size, position, corner radius, and (for modal) the backdrop. When a study is launched from an audience distribution, the dashboard’s display settings apply automatically, and anything you pass yourself overrides them.

​

Repeat and fresh sessions

Two common controls shape whether a user sees a study again:

• Skip if already seen: don’t present to someone who has already been exposed to this study.
• Force a fresh session: ignore any saved progress and start the interview over.

​

Lifecycle events

Register listeners before you present so you capture every event: Use these to log exposure, trigger follow-up UI, or react to completion.

​

Per-platform reference

​

Further reading