QuizFlow LabsQuizFlow Labs
Docs

Leads vs. Submissions Analytics

Submissions and leads surface in the same dashboards, but they are counted and enforced differently. This page unpacks what each metric really means so you can interpret your usage, conversions, and limits as you explore /doc/usage and the analytics docs.

Core definitions

  • Submissions this month: Every completed submission accepted by POST /api/submissions for a published quiz. The counter rolls up across all of one account’s quizzes and resets at the UTC month boundary.
  • Leads this month: Each capture of a lead_email stored in the leads table through the lead capture block. Free plans use the UTC month window, paid plans align with the billing period start.

Where the numbers appear

  • Dashboard cards: Submissions this month and Leads this month sit next to each other under the analytics cards in the dashboard so you can quickly compare volume versus contact collection.
  • Leads & submissions chart: Available on paid plans, this area chart stacks both metrics for the last 7 / 30 / 90 days; spikes show whether a completion also yielded a lead or if a funnel drop-off needs investigation.
  • Per-quiz drill downs: Dashboard > Quizzes > Submissions lists every completion record, while Dashboard > Quizzes > Leads only lists submissions that captured lead details.
  • Analytics docs: See /doc/analytics/usage-and-limits for how the dashboard defines usage, and /doc/usage for plan-level enforcement.

Limits and enforcement

  • Submission limits: When the response limit is hit, the submissions API returns LIMIT_REACHED (HTTP 429) and no new submissions are accepted until the next period. Lead capture stops because submissions stop.
  • Lead limits: Once the lead limit is reached (the API replies with lead_limit_reached), the submission still completes but the lead details are not stored; the card and chart show a flat line for leads while submissions may continue.
  • Plan visibility: Lead limits are enforced per account in the billing window for paid plans or the UTC month for free plans. Submissions always follow the UTC month boundary for counting and charting.
  • Interpretation tip: A gap between submissions and leads almost always means a lead capture block is skipped, missing, or has conditional logic—confirm the lead step is still present on the quiz before assuming limits are the cause.

Investigating differences

  • Compare Submissions this month to Leads this month after campaigns to estimate your lead capture conversion on a given quiz.
  • Use /api/leads exports (see /doc/analytics/exporting-data) to verify whether a lead email was recorded for every submission you expect.
  • Look for lead_limit_reached rows in your logs or in the UI preservation message to validate whether a missing lead is due to a limit rather than a builder change.

Related resources