Implement survey popup delay (surveyPopupDelaySeconds)

[adboio]

🚨 IMPORTANT

This issue is likely user-facing in the main PostHog app, see surveyVersionRequirements.ts. If you delete or close this issue, be sure to update the version requirements list here.

Summary

The posthog-flutter SDK does not implement the survey popup delay (surveyPopupDelaySeconds). The field is not present in the Flutter SDK code at all.

Current State

• No surveyPopupDelaySeconds field or delay logic exists in the Flutter SDK
• The underlying native SDKs (iOS and Android) have the field in their models but do not implement the delay behavior either

Expected Behavior

When survey.appearance.surveyPopupDelaySeconds is set to a value > 0:

1. The survey popup should be delayed by that many seconds before being shown
2. Surveys should be sorted by their delay value (shorter delays first)

Dependencies

This depends on either:

• The Flutter SDK implementing the delay itself in its survey rendering code
• Or the native SDKs implementing it (iOS needs rendering delay, Android needs to expose on display model)

Reference Implementation

See posthog-js browser: packages/browser/src/extensions/surveys.tsx — _handlePopover() method which uses setTimeout for the delay.

Tracking

This is tracked in the survey SDK feature parity issue: PostHog/posthog#45658

This issue was generated by Claude using the /survey-sdk-audit skill.

[darkopia]

+1 https://posthoghelp.zendesk.com/agent/tickets/52294

[isabelle-galvao]

Hi team,

I've been testing surveys with popover display in a Flutter app and noticed that the delay setting configured in the PostHog UI (under Survey Customization) is completely ignored by the Flutter SDK. The popover appears instantly as soon as the trigger event is captured, regardless of the delay value set.

Expected behavior: The survey popover should wait the configured number of seconds after the trigger event before appearing.

Actual behavior: The survey popover appears immediately when the trigger event is fired, with no delay.

Workaround used: Implementing Future.delayed in the Flutter code before capturing the trigger event, which works but requires a new app release to change the delay value.

It would be great to have the delay setting honored natively by the Flutter SDK, ideally matching the behavior already available on web, iOS, and React Native.

Thanks!