Documentation

Sabotiq Quiz Engine — Free & Pro

Installation

Free Version (WordPress.org)

1. Go to Plugins → Add New in your WordPress admin.
2. Search for "Sabotiq Quiz Engine".
3. Click Install Now, then Activate.
4. A new "Sabotiq Quizzes" menu will appear in your dashboard.

Pro Version (Upgrade)

1. Purchase a Pro license at sabotiq.pro.
2. Download the Pro plugin ZIP from your Freemius confirmation email or dashboard.
3. Go to Plugins → Add New → Upload Plugin and upload the ZIP file.
4. Activate the Pro plugin. If the free version was active, deactivate it first — your quizzes and data will be preserved.
5. Enter your license key when prompted (or go to Sabotiq Quizzes → Account).

Your First Quiz

1. Go to Sabotiq Quizzes → Add New Quiz.
2. Give your quiz a title.
3. Click "Add Question" and enter your question text.
4. Add answer options and mark the correct one(s).
5. Repeat for all your questions.
6. In the right sidebar, configure your quiz settings (layout, timer, gamification, etc.).
7. Click Publish.
8. Copy the shortcode shown at the top (e.g., [sabotiq_quiz id="123"]).
9. Paste the shortcode into any page or post.

Embedding Quizzes

Shortcode (Recommended)

The primary way to embed a quiz is using the shortcode:

[sabotiq_quiz id="123"]

This works with any WordPress page builder (Gutenberg, Elementor, Divi, WPBakery, etc.).

External Iframe Embedding

You can embed quizzes on non-WordPress sites (Shopify, Webflow, static HTML) using an iframe. The plugin generates an iframe endpoint automatically:

<iframe src="https://yoursite.com/?sbq_iframe=123" width="100%" height="700" frameborder="0"></iframe>

Replace 123 with your quiz ID and yoursite.com with your WordPress domain.

Classic Multiple Choice

The standard quiz question type. Display a question with 2–6 answer options. One answer is marked as correct. Optionally add an image or YouTube video to the question, and images to individual answers (which creates an automatic 2×2 image grid).

Settings per question:

• Question text — the main question.
• Question image/video — optional visual content (URL to an image or YouTube link).
• Answers — 2–6 options, each with text, a correct/incorrect toggle, and an optional image URL.
• Explanation — shown after the user answers (optional).

Range Slider

Users guess an exact number by dragging a slider. Great for "How many…?", "What year…?", or "What percentage…?" questions. You set the minimum, maximum, and correct value. The closer the user's guess, the more points they earn.

Text Input

Users type their answer. The plugin checks it against the correct answer (case-insensitive). Perfect for "Name this…" or "What is…?" questions.

Checkboxes

Multiple correct answers are possible. Users check all that apply. Scoring is based on how many correct answers the user selects without selecting incorrect ones.

Image Hotspot

Upload an image and draw a polygon region over the correct area. Users must click within the target zone to answer correctly. Use this for geography quizzes, anatomy, hidden-object challenges, or "find the difference" puzzles.

Gamification & Coins

Every quiz includes a virtual coin economy. Users earn coins for correct answers and can spend them on power-ups:

Power-Up	Cost	Effect
50:50	Coins	Eliminates two wrong answers
Time Freeze	Coins	Pauses the question timer
Shield	Coins	Protects against losing points on a wrong answer

Additionally, Pro users have access to two special game modes:

• Wager Mode — users bet their coins before answering. High risk, high reward.
• Crowd Mode — no right or wrong answers. Users vote and see live community statistics.

Leaderboard

A built-in leaderboard displays top scores for each quiz. Players are identified by their display name (or Google account if Google Sign-In is enabled). The leaderboard updates in real-time.

Lead Capture

Enable email opt-in to collect leads before showing quiz results. When enabled, users must enter their name and email to see their score. Collected leads are stored in the WordPress database and can be exported from Sabotiq Quizzes → Leads.

CSV / Excel Import

Bulk-import questions from CSV or Excel files. Go to Sabotiq Quizzes → Import (CSV/Excel).

Supported formats:

• .csv — semicolon-separated (free & Pro)
• .xlsx — Excel 2007+ (Pro only)
• .xls — Legacy Excel (Pro only)

CSV format:

Each quiz starts with a QUIZ row, followed by QUESTION and ANSWER rows:

QUIZ;My Quiz Title
QUESTION;What is 2+2?;classic;;Explanation text here
ANSWER;3;FALSE
ANSWER;4;TRUE
ANSWER;5;FALSE

The question row format is: QUESTION;text;type;image_url;explanation

Supported types: classic, wager, crowd, hotspot, personality

Welcome Screen

Show a branded welcome screen before the quiz starts. Configure it in the quiz settings sidebar:

• Cover Image — select from the media library.
• Title — e.g., "Ready to test your knowledge?"
• Description — a short intro text.
• Button Text — e.g., "Start Quiz Now"

AI Quiz Generator

Setup:

1. Get an API key from platform.openai.com.
2. Go to Sabotiq Quizzes → Settings & Integrations.
3. Paste your API key in the OpenAI API Key field and save.

Usage:

1. When creating a new quiz, click the AI Generator button.
2. Paste any text, article, URL, or topic description.
3. The AI generates a full quiz with questions, correct answers, and explanations.
4. Review and edit the generated questions as needed.

Typical cost: $0.01–$0.03 per quiz (20 questions) via OpenAI's pay-as-you-go pricing.

Payment Gates (Stripe & PayPal)

Setup:

1. Go to Sabotiq Quizzes → Settings & Integrations.
2. Enter your Stripe publishable key and secret key, and/or your PayPal client ID and secret key.
3. Save settings.

Per-quiz configuration:

1. Edit a quiz and find the Result Gate section in the sidebar.
2. Select gate type: Stripe, PayPal, or None.
3. Set the price and currency.

Users can take the quiz for free, but their detailed results are locked behind a one-time payment. After payment verification (server-side), results are revealed instantly.

Supported currencies:

USD, EUR, GBP are built-in. You can add custom currencies (RON, TRY, ILS, etc.) in the Global Settings under Custom Currencies.

Webhooks & CRM Integration

Send quiz results to external services via webhook. Enter a webhook URL in the per-quiz settings. When a user completes the quiz, the plugin sends a POST request containing:

• User's email and name (if lead capture is enabled)
• Quiz title and ID
• Score and percentage
• Outcome/personality result (if applicable)

Works with Zapier, Make (Integromat), Pabbly, or any custom endpoint.

A/B Testing

Create a variant of any quiz and assign it as an A/B test. The plugin automatically splits traffic between the original and variant using cookies (so each user consistently sees the same version). Compare completion rates, scores, and conversion metrics to find the version that performs best.

Setup:

1. Create your original quiz and publish it.
2. Create a second quiz (the variant) with different questions, order, or settings.
3. In the variant quiz settings, set the A/B Variant ID to the original quiz's ID.
4. Embed the original quiz shortcode — the plugin handles the rest.

PDF Certificates

Award branded PDF certificates when users complete a quiz. Configure in the per-quiz settings:

• Certificate Title — e.g., "Certificate of Achievement"
• Certificate Text — e.g., "has successfully completed the challenge"
• Logo — upload your brand logo

A "Download Certificate" button appears on the results screen.

Migration Wizard

Import quizzes from 10+ other WordPress quiz plugins in a single click. Go to Sabotiq Quizzes → Migration Wizard.

Supported plugins:

Quiz Maker, LearnDash, Quiz and Survey Master (QSM), WP Quiz Pro, HD Quiz, and more. The wizard automatically detects installed quiz plugins and shows available imports.

No-Code Shortcode Hijacking:

After migration, you don't need to update your pages. The plugin automatically detects old shortcodes from the original plugin and displays your new Sabotiq quizzes in their place.

Global Settings

Go to Sabotiq Quizzes → Settings & Integrations to configure:

Setting	Description	Plan
OpenAI API Key	Powers the AI Quiz Generator	Pro
Google Client ID	Enables Google Sign-In for quiz-takers	Pro
Stripe Keys	Public + Secret key for payment gates	Pro
PayPal Keys	Client ID + Secret for payment gates	Pro
Custom Currencies	Add currencies beyond USD/EUR/GBP (e.g., RON, TRY)	Pro

Per-Quiz Settings

Each quiz has its own settings panel in the right sidebar of the quiz editor:

Setting	Description	Plan
Layout	Card (one question at a time) or List (all visible)	Free
Quiz Type	Classic, Personality, Wager, or Crowd	Free*
Progress Bar	Show progress in Card view	Free
Welcome Screen	Custom intro with image, title, description	Free
Shuffle Answers	Randomize answer order	Free
Shuffle Questions	Randomize question order	Free
Timer	Per-question countdown timer (seconds)	Pro
Pool Limit	Show random N questions from the full set	Pro
Retake Limit	Max quiz attempts per user (cookie-based)	Pro
Negative Marking	Deduct points for wrong answers	Pro
Review Answers	Show correct answers after completion	Free
Social Sharing	Facebook, X, WhatsApp share buttons	Pro
Result Gate	Lock results behind Stripe/PayPal payment	Pro
Webhook URL	Send results to Zapier/CRM	Pro
Certificate	Enable PDF certificate download	Pro
Ad Frequency	Show ads every N questions	Pro
A/B Variant ID	Link to original quiz for split testing	Pro

* Wager and Crowd modes are available in the free plugin for question creation but require Pro for the full gameplay experience.