Guides

Match Quiz

Interactive match prediction quiz across many football markets, with countdown, points, and leaderboards.

Interactive match prediction quiz that allows users to make predictions on various football match markets. Features multiple fixture types, real-time countdown timers, points system, and comprehensive result tracking with leaderboards.

<div
	data-component="fu-widget"
	data-content-type="match-quiz"
	data-content-id="your-match-quiz-id"
	data-lead-fields="fullName,email"
	data-lead-position="after"
	data-lead-sync-with-profile="true"
	data-campaign-id="campaign-1"
	data-campaign-name="Summer Campaign"
	data-signin-cta-label="Sign in to compete!"
	data-signin-cta-onclick="showSignInModal()"
	data-layout-template="STANDARD"
	data-image-position="left"
	data-show-countdown="true"
	data-show-team-labels="true"
	data-show-points="true"
	data-show-prediction-details="true"
></div>

Configuration Attributes

AttributeDescriptionOptionsDefault
data-layout-templateVisual layout of the match quiz"STANDARD", "SPLIT", "OVERLAY""STANDARD"
data-image-positionPosition of images in the quiz"left", "right"Config default
data-show-countdownShow countdown timer when Match Quiz is open"true", "false""false"
data-show-team-labelsShow team name labels in fixture components"true", "false""true"
data-show-pointsShow points display for each fixture"true", "false""false"
data-show-prediction-detailsShow detailed prediction results after completion"true", "false""false"
data-lead-sync-with-profileSync anonymous profiles to database after lead submission"true", "false"Config default

Features

  • Multiple prediction markets (1X2, Correct Score, Player Markets, Over/Under Goals, Corners, etc.)
  • Real-time countdown timer for prediction cutoff
  • Points system with loyalty integration
  • Leaderboard and ranking system
  • Prediction summary and editing capabilities
  • Three responsive templates (Standard, Split, Overlay)
  • Lead collection integration
  • Authentication support
  • Custom theming and branding
  • Detailed prediction results and explanations

Supported Markets

MatchQuiz supports a wide variety of football prediction markets.

Match Result Markets

  • FT_1X2 — Full Time 1X2 (Home Win, Draw, Away Win)
  • HT_1X2 — Half Time 1X2

Score Markets

  • CORRECT_SCORE — Exact final score prediction
  • CORRECT_SCORE_HT — Exact half-time score prediction
  • CORRECT_SCORE_ADVANCED — Advanced correct score with alternative points

Player Markets

  • PLAYER_SCORE_FIRST_GOAL — First goalscorer prediction
  • PLAYER_SCORE — Anytime goalscorer
  • PLAYER_YELLOW_CARD — Player to receive yellow card
  • PLAYER_RED_CARD — Player to receive red card
  • PLAYER_SCORE_HATTRICK — Player to score hat-trick
  • PLAYER_SCORE_TWICE — Player to score twice

Over/Under Markets

  • OVER_GOALS_0_5 to OVER_GOALS_6_5 — Total goals over/under
  • OVER_CORNERS_6_5 to OVER_CORNERS_13_5 — Total corners over/under

Special Markets

  • CORNERS_MATCH — Total corners in the match
  • PENALTY_MATCH — Penalty awarded in the match
  • RED_CARD_MATCH — Red card shown in the match

Game Status States

Match quizzes have 5 distinct status states:

  • PENDING — Not yet open for predictions
  • OPEN — Ready for predictions (default state)
  • LIVE — Match has started, no new predictions accepted
  • CLOSED — Match finished, backend resolving predictions
  • SETTLED — Predictions resolved, leaderboard available

Authentication and Sign-in

When the match quiz's auth requirement is set to "REGISTERED" in the Management Portal, unauthenticated users will see a customizable sign-in CTA instead of the quiz interface. The sign-in behavior can be configured globally or per-widget using the data-signin-cta-label and data-signin-cta-onclick attributes.

📘

Related (see the Features page): Lead Collection · Sign-in & Additional CTA · Rules Display · Authentication Requirements. Market keys: API Reference → Market Types.