QuizFlow LabsQuizFlow Labs
Docs

Upgrading & Locked Features

Upgrade hints, disabled controls, and API errors such as LIMIT_REACHED all stem from the entitlement model. This guide explains what’s locked, why it’s locked, and how to unlock it.

Why features lock

  • Paid entitlements: Hard gates, email notifications, CSV exports, and branding controls require a paid-active plan (basic, pro, team). Trialing or active statuses keep these entitlements unlocked; canceled or delinquent accounts revert to the free experience.
  • Feature keys: branding_controls gates badge removal, logos, and completion copy; response_export unlocks CSV downloads; quiz_publish enforces lead caps when publishing.
  • Publish gating: Full-Page mode, split layouts, and embeds run through getPublishGatingError and block publishing until the plan matches the required entitlement.

Locked builder & dashboard features

  • Hard gate: Basic+ only. Free plans see "Hard gate requires the Basic plan" and submissions fall back to soft-gate behavior.
  • Branding/completion controls: Free plans hide custom completion copy inputs and keep the QuizFlow Labs badge visible.
  • File upload block: Requires Pro; the builder shows an upgrade hint in the block settings if you are not on Pro/Team.
  • Question split media override: Visible in Block Settings for eligible question blocks, but locked unless the account can use Full-Page Split (Pro/Team).
  • Scoring & completion rules: Pro/Team only; hovering these controls surfaces the pro badge.
  • Full-Page presentations: Paid-only; split layouts and embeds need Pro/Team and publishing fails with a clear error if entitlements are missing.
  • Integrations & advanced analytics: Locked to Pro/Team, while Basic displays the pane with upgrade messaging.
  • Projects: Basic can create up to three projects, Pro/Team are unlimited, and free plans cannot create new projects.
  • CSV exports & notifications: Paid plans surface export buttons and email toggles; free plans keep them hidden.

When usage limits block you

  • Responses: The submissions API responds with LIMIT_REACHED (HTTP 429) once you hit your monthly cap; submissions are discarded until the next UTC month.
  • Leads: Lead capture returns lead_limit_reached and stops saving emails. Hard gate submissions continue, but lead_email becomes null.
  • Publishing after cap: quiz_publish compares current lead usage to the limit and blocks publishing with "Monthly lead limit reached." until the billing window resets or you upgrade.
  • Reset windows: Responses reset on the 1st of each UTC month; paid plans track leads from the billing period start while the free plan resets by UTC month.

Upgrade pathways

  1. Compare tiers on /pricing.
  2. Click the Upgrade button on /dashboard/billing (paid accounts see Manage billing instead).
  3. After payment, refresh the dashboard/builder so entitlements are reloaded.
  4. Need help? Contact support via /contact for custom team setups or usage questions.

Upgrading keeps entitlements and limits aligned, so unlocked sections stay available once the new plan is active.

Still seeing a lock? Confirm the billing page shows the new plan and, if it does, sign out and back in to reset the entitlement cache.