QuizFlow LabsQuizFlow Labs
Docs

Usage Limits

Usage limits define monthly caps for responses, leads, and active quizzes in QuizFlow Labs. They exist to keep completion flows reliable and align plan capacity with system cost. Understanding how they are counted helps protect the completion moment.

Core Concepts & Definitions

  • Monthly Responses: A successful submission accepted for a published quiz, counted per quiz owner across all quizzes.
  • Monthly Leads: A submission that stores a lead email from the lead capture step, counted per quiz owner.
  • Active Quizzes: Quizzes with status published; drafts are not active.

Monthly Responses

What it means

A monthly response is recorded when a published quiz accepts a new submission through the submissions API.

Why it matters

  • Scale: Higher response volume increases storage and processing.
  • Performance protection: Caps prevent overload during spikes.
  • Plan alignment: Limits match expected usage for each plan.

How it is measured

  • Trigger: A new submission is accepted by POST /api/submissions for a published quiz.
  • Storage: Counters are stored per owner in usage_counters with key responses_collected.
  • Scope: Counts aggregate across all quizzes owned by the same account.
  • Does not count: Draft quizzes, page views, step views, or re-submitting the same submission_id.
  • Owner testing: Submissions made while signed in as the quiz owner do not increment the counter.
  • Reset timing: Calendar month boundaries in UTC (period starts on the 1st at 00:00 UTC).

How to monitor responses

  • Dashboard: Submissions this month shows monthly submissions vs your response limit.
  • Chart: Leads & submissions chart shows submissions over time (paid plans).
  • Per quiz: Dashboard > Quizzes > Submissions lists all submissions for a quiz.
  • Analytics doc: See /doc/analytics/usage-and-limits.

What happens at the limit

When the response limit is reached, the submissions API returns LIMIT_REACHED (HTTP 429). The respondent sees a limit message and the submission is not recorded.

Plan availability

  • Free: 100
  • Basic: 1,000
  • Pro: 5,000+

Note: Pro is configured at 5,000 responses; higher tiers can exceed this limit.

Monthly Leads

What it means

A monthly lead is counted when a submission stores a non-null lead_email captured from the lead capture block.

Why it matters

  • Funnel quality: Lead volume indicates how many completions provide contact details.
  • Operational load: Lead follow-up workflows scale with captured contacts.
  • Plan alignment: Lead caps reflect expected follow-up capacity per plan.

How it is measured

  • Trigger: Lead capture submits via POST /api/leads for a published quiz.
  • Storage: Lead details are stored in leads; lead limits are enforced using submissions.lead_email.
  • Scope: Counts aggregate across all quizzes owned by the same account.
  • Applies when: The quiz definition includes a lead capture block.
  • Does not count: Lead capture attempts after the limit is reached or submissions without lead_email.
  • Reset timing: Lead limits are enforced by calendar month in UTC.

How to monitor leads

  • Dashboard: Leads this month shows lead usage vs your lead limit.
  • Per quiz: Dashboard > Quizzes > Leads lists captured leads.
  • Billing period note: Paid plans calculate lead usage from leads using the current billing period start; free plans use the current UTC month.
  • Analytics doc: See /doc/analytics/usage-and-limits.

What happens at the limit

When the lead limit is reached, the lead capture API responds with lead_limit_reached. The lead capture step shows a limit message and the lead is not stored. If the quiz uses a hard gate, submissions continue but lead details are skipped once the limit is reached.

Plan availability

  • Free: 50
  • Basic: 200
  • Pro: 1,000

Active Quizzes

What it means

An active quiz is any quiz with status published. Drafts are not active.

How QuizFlow Labs treats active quizzes

Active quiz counts are used for dashboard visibility (for example, Published Quizzes) but are not enforced as a limit in code.

When this matters

  • Organization: Keep published quizzes focused on what is live.
  • Performance: Fewer published quizzes reduce operational noise.
  • Reporting clarity: Active status keeps dashboards aligned with real traffic.

Plan availability

Unlimited on all plans.

Monitoring & Reporting

  • The dashboard shows Submissions this month, Leads this month, and a Leads & submissions chart.
  • Per-quiz pages list individual submissions and leads.
  • Analytics views read from the submissions and leads tables.

Common Questions & Edge Cases

  • Do drafts count as active quizzes? No. Only quizzes with status published are active.
  • Does refreshing a quiz count as a response? No. Responses are counted only when a submission is accepted.
  • Do repeat submissions count? Re-submitting the same submission_id updates the existing submission and does not increment the response counter.
  • Are limits shared across quizzes? Yes. Response and lead limits aggregate across all quizzes owned by the same account.
  • What happens if I exceed my response limit? Submissions are blocked with a LIMIT_REACHED response until the next period.
  • What if my lead limit is reached on a hard gate? The quiz allows completion without saving lead details.

Related Documentation