WPC Shop Quiz is a guided selling plugin for WooCommerce that helps shoppers find products through interactive question flows. Create quizzes that ask relevant questions, adapt to shopper selections in real time, and display matching product recommendations automatically. From skincare routines and
PricingFree downloadThe WordPress.org download is free. Pro versions, add-ons or external services may cost extra.
CompatibilityRequires WordPress 5.9 and PHP 7.4.
SourceWordPress plugins · Oct 18, 2026
01 / Source details
About this tool.
WPC Shop Quiz is a guided selling plugin for WooCommerce that helps shoppers find products through interactive question flows. Create quizzes that ask relevant questions, adapt to shopper selections in real time, and display matching product recommendations automatically.
From skincare routines and electronics bundles to fashion fits and gift guides, Shop Quiz provides a structured discovery flow tailored to your product catalog.
Live demo
Visit our live demo to see how this plugin works.
Overview
Visual quiz builder — drag-and-drop interface, no coding needed.
Two recommendation engines — Weighted Scoring for large catalogs, Direct Mapping for precise control.
Conditional Logic — branching flows that skip irrelevant questions and create a unique path for each user.
Built-in lead capture — Email Gate collects guest emails before revealing results.
Shop Quiz offers two distinct recommendation modes, each designed for a different catalog strategy.
Weighted Scoring Each answer assigns points to product properties — attributes, categories, tags, price ranges, stock levels, ratings, and sale status. When the quiz completes, every product in your catalog is scored and the top matches are ranked automatically.
No manual product mapping required — suitable for catalogs with 50+ products
Products are ranked by total accumulated score across all answers
Admin can configure weight values per answer option
Direct Mapping For stores that need exact control, each answer option directly maps to specific products. The final recommendation is the intersection (or union) of all mapped product sets.
Precise control over which products appear for which answer combinations
Suitable for small catalogs or curated product lines
Simple “if this, then that” configuration
🔀 Conditional Logic
Not every customer should answer every question. Conditional Logic creates personalized, branching quiz flows:
Show rule: Display a step only when a condition matches (e.g., show “Skin concerns” only if user selected “Skincare” in step 1)
Skip rule: Always skip a step when a condition matches (e.g., skip “Budget” for returning customers)
Conditions reference any previous step’s selected answer(s)
Multiple conditions per step with AND/OR logic
Steps are recalculated dynamically after each answer — the progress bar and step count update in real time
How it works:
01Admin sets rules per step in the quiz builder (e.g., “Show this step only if Step 1 answer = ‘Outdoor'”)
02After each answer, the engine recalculates which steps are visible
03Skipped steps are hidden from the progress bar and navigation
04The quiz flow adapts dynamically to each user’s answers
👋 Welcome Screen
An optional branded landing screen that appears before the first question, setting context and expectations.
Configuration: * Toggle: Enable / Disable per quiz * Customizable heading (default: “Find Your Match”) * Customizable description (default: “Answer a few quick questions…”) * Customizable Start button text (default: “Start Quiz”) * Placeholder text auto-fills when fields are left blank * Displayed in both live quizzes and builder preview
Navigation behavior: * Clicking “Start Quiz” fades out the welcome screen and reveals the first question * At Step 1, a “Back” button navigates back to the Welcome Screen * Quiz Starts are only counted when the user clicks “Start Quiz” — not on page load
🎟️ Smart Coupon Incentives
Reward quiz completions with auto-generated WooCommerce coupons. The coupon system is designed to provide incentives while preventing abuse.
Coupon features: * Auto-generated unique codes with configurable prefix (e.g., QUIZ-A3KF9B ) * Discount type: percentage or fixed amount * Individual use enforcement (cannot combine with other coupons) * 30-day expiration * Usage limit: 1 per coupon
Anti-abuse deduplication: The system checks three identity layers before generating a new coupon:
05User ID — for logged-in customers, checks if they already have an active coupon for this quiz
06Email — for guests with Email Gate, checks by email address
07Session key — for anonymous guests, checks by browser session
If an active (unused, unexpired) coupon is found → the existing code is returned instead of creating a new one.
Cart validation: Quiz coupons only work when the cart contains at least one product from the quiz’s recommended results. This prevents coupon sharing and off-quiz usage.
📧 Email Gate
Capture guest emails as a lead generation tool before showing quiz results.
Behavior: * Only appears for non-logged-in visitors — logged-in users bypass automatically * Always visible in admin Preview mode for testing * Validates email format before allowing submission * Captured emails are stored and associated with the quiz session
Integration with coupons: When both Email Gate and coupons are active, the coupon is automatically restricted to the captured email address — preventing coupon sharing.
🔗 Shareable Results
Users can share their quiz results with friends via a unique URL.
How it works: * After completing a quiz, a “Share Results” button generates a unique link * The shared page shows the same product recommendations * Each share records: quiz ID, answers, recommended products, user email (if captured), and timestamp * Admin can view all shared pages in a dedicated management table
Guest tracking: When a guest with Email Gate shares results, their email is displayed alongside the share record for reference.
🔌 Webhooks & REST API
Integrate Shop Quiz with any external system through real-time webhooks and a RESTful API.
Outbound Webhooks Configure a single webhook URL to receive POST requests with structured JSON payloads for three events:
quiz.completed — fires when a user finishes a quiz (includes quiz ID, answers, recommended products, user data)
quiz.conversion — fires when a recommended product is added to cart (includes product details, session)
quiz.coupon_used — fires when a quiz-generated coupon is redeemed (includes coupon details, discount amount)
Security: * HMAC-SHA256 signature in X-WPCSQ-Signature header for payload verification * Unique delivery ID in X-WPCSQ-Delivery header * Plugin version in X-WPCSQ-Plugin-Version header * Async dispatch via WP-Cron — webhooks never block the user’s request
REST API: Full CRUD endpoints under wpcsq/v1/ for quizzes, submissions, and results — suitable for headless WooCommerce implementations.
🎨 Themes & Customization
Six built-in color themes with a custom color override:
Default — Indigo (#6366f1)
Emerald — Green (#10b981)
Rose — Pink (#f43f5e)
Amber — Orange (#f59e0b)
Cyan — Blue (#06b6d4)
Slate — Gray (#64748b)
Custom — any hex color via color picker
Transitions: * Slide — horizontal slide with direction awareness (left/right) * Fade — smooth opacity transition
Display modes: * Inline shortcode: [wpcsq_quiz id="123"] — renders directly on the page * Popup modal: [wpcsq_btn id="123"] — click-to-open modal overlay * Floating button: global quiz accessible from any page
📋 Shortcodes
[wpcsq_quiz]
Render a quiz inline on any page or post.
[wpcsq_quiz id="123"]
[wpcsq_btn]
Render a clickable button that opens the quiz in a modal overlay.
[wpcsq_btn id="123"]
Supports text attribute for custom button label: [wpcsq_btn id=”123″ text=”Find your match → ”]
[wpcsq_share]
Render shared quiz results on a designated share page.
[wpcsq_share]
Place this shortcode on the page selected as “Share Results Page” in Global Settings.
02 / Source details
Getting started.
01Ensure WooCommerce is installed and activated.
02Upload the plugin folder to /wp-content/plugins/ or install via Plugins > Add New .
03Activate the plugin through the Plugins menu.
04Go to WP-admin > Shop Quiz to create your first quiz.
03 / Source details
Frequently asked questions.
How does the scoring engine recommend products?
In Weighted Scoring mode, each answer assigns points to product properties (attributes, categories, tags, price range, ratings, etc.). When the quiz completes, every product in your catalog is scored and the top-scoring products are recommended. In Direct Mapping mode, each answer maps directly to specific products.
Can I create branching quiz flows?
Yes. Conditional Logic lets you show or skip steps based on previous answers. For example, show a “Skin concerns” step only if the user selected “Skincare” in the first question. Steps are recalculated in real time after each answer.
How does the coupon system prevent abuse?
Coupons are deduplicated by user ID, email, and session key. Retaking the quiz returns the same active coupon instead of generating a new one. Additionally, coupons are email-restricted (when Email Gate is active) and cart-validated (only work with quiz-recommended products in the cart).
When is a “Quiz Start” counted?
Starts are only counted when the user takes a meaningful action — clicking “Start Quiz” on the Welcome Screen, or clicking “Next” on the first question. Simply loading the page does not count as a start.
Can I test my quiz before publishing?
Yes. The built-in Preview mode renders your quiz exactly as customers see it, with a device switcher for desktop, tablet, and mobile views. Welcome Screen and Email Gate are both visible in preview mode.
Is it compatible with page builders?
Yes. Shop Quiz works via shortcodes ( [wpcsq_quiz] , [wpcsq_btn] ) which are compatible with Elementor, WPBakery, Gutenberg, and any page builder that supports shortcodes.
Does it work with HPOS?
Yes, the plugin is fully compatible with WooCommerce High-Performance Order Storage (HPOS).
How does result caching work?
When caching is enabled, identical answer combinations return cached product results instead of recalculating scores. Cache TTL is configurable from 1 hour to 7 days. Coupons are never cached — they always run through the deduplication logic.
Website LLMs.txt and LLMs-Full.txt Generator is an LLMs.txt generator and llms-full.txt generator for WordPress. It helps site owners generate, manage, preview, validate, and serve AI discovery files from published public content. Use it to create structured /llms.txt and optional /llms-full.txt end
EngageDock AI is a customizable floating contact widget for WordPress websites that want more leads and faster visitor communication. It helps small businesses turn website traffic into calls, texts, emails, and callback requests from one clean contact panel. Key Features: Click-to-Call – One tap ca
Altify AI is an auto ALT text and AI ALT text plugin for WordPress images. It helps generate descriptive image ALT text for accessibility and image SEO. Use bulk image ALT text tools for your Media Library, generate featured image ALT text automatically, and scale WooCommerce image ALT updates with
The Accepted Payment Methods plugin is a straightforward, lightweight solution that enhances your website by displaying visually appealing icons of the payment methods you accept. This plugin is ideal for a variety of websites, including e-commerce platforms, service-oriented websites, and informati
