{"id":303590,"date":"2026-05-11T21:48:01","date_gmt":"2026-05-11T21:48:01","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/decision-widget-product-quiz-recommendations\/"},"modified":"2026-05-11T21:47:24","modified_gmt":"2026-05-11T21:47:24","slug":"decision-widget","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/decision-widget\/","author":14961740,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.0","stable_tag":"1.1.0","tested":"6.9.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Decision Widget \u2014 Product Quiz Recommendations","header_author":"Decision Widget","header_description":"Embed AI-powered product recommendation quizzes on your site. Help visitors find the perfect product in 60 seconds.","assets_banners_color":"7787bb","last_updated":"2026-05-11 21:47:24","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.decisionwidget.net\/partners","header_author_uri":"https:\/\/www.decisionwidget.net","rating":0,"author_block_rating":0,"active_installs":0,"downloads":16,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.0":{"tag":"1.1.0","author":"joelchouinard","date":"2026-05-11 21:47:24"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3529223,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3529223,"resolution":"256x256","location":"assets","locale":""},"icon.svg":{"filename":"icon.svg","revision":3529223,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3529223,"resolution":"1544x500","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":{"decisionwidget\/quiz-embed":{"name":"decisionwidget\/quiz-embed","title":"Decision Widget"}},"tagged_versions":["1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3529223,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3529223,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3529223,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3529223,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3529223,"resolution":"5","location":"assets","locale":""}},"screenshots":{"1":"Setup wizard \u2014 connect in 30 seconds","2":"Category browser \u2014 search and click to copy shortcode","3":"Gutenberg block \u2014 drag, drop, select category","4":"Embedded quiz \u2014 visitors answer 5 questions","5":"Recommendations \u2014 personalized match with deal badges"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[369,209,230,139790,583],"plugin_category":[35,45,53],"plugin_contributors":[262606],"plugin_business_model":[],"class_list":["post-303590","plugin","type-plugin","status-publish","hentry","plugin_tags-affiliate","plugin_tags-amazon","plugin_tags-embed","plugin_tags-product-recommendations","plugin_tags-quiz","plugin_category-advertising","plugin_category-ecommerce","plugin_category-ratings-and-reviews","plugin_contributors-joelchouinard","plugin_committers-joelchouinard"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/decision-widget\/assets\/icon.svg?rev=3529223","icon":"https:\/\/ps.w.org\/decision-widget\/assets\/icon.svg?rev=3529223","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/decision-widget\/assets\/screenshot-1.png?rev=3529223","caption":"Setup wizard \u2014 connect in 30 seconds"},{"src":"https:\/\/ps.w.org\/decision-widget\/assets\/screenshot-2.png?rev=3529223","caption":"Category browser \u2014 search and click to copy shortcode"},{"src":"https:\/\/ps.w.org\/decision-widget\/assets\/screenshot-3.png?rev=3529223","caption":"Gutenberg block \u2014 drag, drop, select category"},{"src":"https:\/\/ps.w.org\/decision-widget\/assets\/screenshot-4.png?rev=3529223","caption":"Embedded quiz \u2014 visitors answer 5 questions"},{"src":"https:\/\/ps.w.org\/decision-widget\/assets\/screenshot-5.png?rev=3529223","caption":"Recommendations \u2014 personalized match with deal badges"}],"raw_content":"\n

Stop listing products. Start recommending them.<\/strong><\/p>\n\n

DecisionWidget turns your affiliate content into an interactive recommendation engine. Instead of static \"top 10\" lists your readers skim and bounce from, they take a 5-question quiz and get a personalized match \u2014 with transparent scoring that shows exactly why each product was recommended.<\/p>\n\n

Drop in one shortcode. Pick from 359 categories. Done.<\/strong><\/p>\n\n

Everything included, free forever:<\/h4>\n\n
    \n
  • 359 ready-to-embed categories<\/strong> \u2014 from stand mixers to noise-cancelling headphones to mechanical keyboards<\/li>\n
  • 9,000+ curated products<\/strong> \u2014 individually vetted, 4.5+ star rated, scored against real buying criteria<\/li>\n
  • Live retailer deal badges<\/strong> \u2014 \"50% off\" and \"Lightning Deal \u2014 3h left\" pulled in real time<\/li>\n
  • AI-generated buying guides<\/strong> \u2014 quality-scored 85+\/100, written specifically for each category<\/li>\n
  • Transparent scoring<\/strong> \u2014 every recommendation shows the why, not just the what<\/li>\n
  • Multi-market support<\/strong> \u2014 automatically routes to the right regional storefront based on visitor location (US\/UK\/CA\/AU)<\/li>\n
  • Gutenberg block + shortcode<\/strong> \u2014 works with any theme, any page builder<\/li>\n
  • Zero maintenance<\/strong> \u2014 products, prices, deals, and content update automatically<\/li>\n<\/ul>\n\n

    Who this is for:<\/h4>\n\n
      \n
    • Affiliate bloggers who want to upgrade from link tables to conversion tools<\/li>\n
    • Review sites that need depth across many categories without hiring writers<\/li>\n
    • Content marketers who want readers to engage, not just skim<\/li>\n
    • Niche site builders who want the conversion lift industry research consistently finds with interactive content vs. static comparison tables (typically 3\u20135\u00d7)<\/li>\n<\/ul>\n\n

      Why publishers are switching from link managers to DecisionWidget:<\/h4>\n\n

      Traditional affiliate plugins help you organize links. DecisionWidget helps your readers decide. That's a categorical difference. Your readers don't want another list \u2014 they want an answer to the question \"which one is right for me?\" DecisionWidget answers it in 30 seconds with scoring they can trust.<\/p>\n\n

      Urgency that converts \u2014 without lifting a finger<\/h4>\n\n

      Static affiliate links have no urgency. DecisionWidget embeds surface real-time retailer deals the moment they happen:<\/p>\n\n

        \n
      • \"50% off \u2014 today only\" badges pulled live from each retailer<\/li>\n
      • Lightning Deal countdowns (\"ends in 2h 47m\")<\/li>\n
      • Price drops flagged automatically<\/li>\n<\/ul>\n\n

        Your readers see the same urgency signals they'd see at the retailer \u2014 except they're deciding before they leave your page.<\/p>\n\n

        What you get vs. building it yourself:<\/h4>\n\n

        Major review sites spend six figures building custom recommendation engines. DecisionWidget drops the same capability into your site in 60 seconds. You focus on writing great content. We handle the products, the quiz logic, the scoring, the deals, the buying guides, the updates.<\/p>\n\n

        Usage<\/h3>\n\n

        Embed Modes:<\/h4>\n\n

        Full Quiz<\/strong> (default) \u2014 Interactive 5-question recommendation quiz:\n [decisionwidget category=\"noise-cancelling-headphones\"]<\/p>\n\n

        Inline CTA<\/strong> \u2014 Subtle mid-paragraph prompt that expands to show top 3 picks:\n [decisionwidget category=\"noise-cancelling-headphones\" mode=\"inline\"]<\/p>\n\n

        Compact Card<\/strong> \u2014 Small sidebar widget showing the #1 pick:\n [decisionwidget category=\"noise-cancelling-headphones\" mode=\"compact\"]<\/p>\n\n

        Versus<\/strong> \u2014 Head-to-head product comparison with specs, winner badge, and verdict:\n [decisionwidget category=\"noise-cancelling-headphones\" mode=\"versus\" versus=\"sony-wh1000xm5_vs_bose-qc-ultra\"]<\/p>\n\n

        With options:<\/h4>\n\n
        [decisionwidget category=\"robot-vacuums\" height=\"800\" theme=\"dark\"]\n<\/code><\/pre>\n\n
        Gutenberg Block:<\/h4>\n\n
        Search for \"Decision Widget\" in the block inserter. Select a category from the dropdown, choose an embed mode, adjust height, and publish. The versus mode includes a text input for the pair slug.<\/p>\n\n
        Example:<\/h4>\n\n
        A food blogger writes \"Best Stand Mixers of 2026.\" Instead of a static comparison table, she drops in [decisionwidget category=\"stand-mixers\"]<\/code>. Her readers answer five quick questions \u2014 budget, capacity, what they bake, countertop space, color preference \u2014 and get a personalized match with live retailer pricing and a Lightning Deal badge.<\/p>\n\n
        Her bounce rate drops. Her affiliate revenue climbs. Her post ranks higher because visitors engage instead of skim. She wrote nothing new. She just added one line.<\/p>\n\n
        For a \"KitchenAid vs Cuisinart\" comparison post, she adds [decisionwidget category=\"stand-mixers\" mode=\"versus\" versus=\"kitchenaid-artisan_vs_cuisinart-precision\"]<\/code> for a head-to-head widget with specs and a winner badge.<\/p>\n\n
        External services<\/h3>\n\n
        This plugin connects to the Decision Widget service hosted at decisionwidget.net to deliver interactive product recommendation quizzes and to power the in-product tools described below. Your readers' visit to your site does not result in any data being sent to Decision Widget; only the plugin's own administrative requests and the visitor's browser loading the embed iframe do.<\/p>\n\n
        The plugin makes the following requests:<\/p>\n\n
        1. Category list \u2014 https:\/\/www.decisionwidget.net\/api\/categories<\/strong><\/p>\n\n
          \n
        • When: Once per day, only after you have given consent in the setup wizard. The list is cached for 24 hours.<\/li>\n
        • What is sent: The standard HTTP request only (no user data, no site URL, no cookies).<\/li>\n
        • Why: To populate the category dropdown in the Gutenberg block and shortcode picker so you can choose which quiz to embed.<\/li>\n<\/ul>\n\n
          2. Account status \u2014 https:\/\/www.decisionwidget.net\/api\/v1\/account\/status<\/strong><\/p>\n\n
            \n
          • When: Only if you have entered a Partner ID in the plugin settings. Cached for 1 hour.<\/li>\n
          • What is sent: Your Partner ID (which you entered yourself).<\/li>\n
          • Why: To display your current plan, monthly click usage, and quota reset date in the plugin settings page.<\/li>\n<\/ul>\n\n
            3. Quiz embed iframe \u2014 https:\/\/www.decisionwidget.net\/embed\/{slug}<\/strong><\/p>\n\n
              \n
            • When: When a page containing the shortcode or Gutenberg block is rendered in a visitor's browser. The iframe is loaded by the visitor's browser, not by your server.<\/li>\n
            • What is sent: The category slug you selected, your Partner ID (if set), the embed mode, and the host page URL (used for click attribution).<\/li>\n
            • Why: To render the interactive quiz inside the iframe.<\/li>\n<\/ul>\n\n
              4. Deactivation feedback \u2014 https:\/\/www.decisionwidget.net\/api\/wp\/deactivation<\/strong><\/p>\n\n
                \n
              • When: Only when you click \"Deactivate\" on the plugin and submit a choice in the deactivation modal that appears (upgrade, leave email for product updates, or deactivate with optional reason). Sent from your administrative browser, not your server.<\/li>\n
              • What is sent: Your selected action (upgrade \/ email \/ remove), an optional email address (only if you typed one), an optional reason code from the dropdown, your site host, your anonymous site ID, and your Partner ID (if set).<\/li>\n
              • Why: To track churn signals and to follow up with product updates if you opted in. Fire-and-forget \u2014 never blocks the deactivation.<\/li>\n<\/ul>\n\n
                5. Post & Page Scanner \u2014 https:\/\/www.decisionwidget.net\/api\/wp\/scan-posts<\/strong><\/p>\n\n
                  \n
                • When: Only when you click \"Scan My Posts\" on the settings page. Sent from your administrative browser.<\/li>\n
                • What is sent: A list of up to 50 of your published posts and pages \u2014 for each: its WordPress post ID, title, excerpt, and URL \u2014 read from your own site's WordPress REST API.<\/li>\n
                • Why: To suggest which posts would benefit from an embedded quiz and which category best fits each one.<\/li>\n<\/ul>\n\n
                  6. Conversation Insights \u2014 https:\/\/www.decisionwidget.net\/api\/wp\/scan-comments<\/strong><\/p>\n\n
                    \n
                  • When: Only when you click \"Scan Comments\" on the settings page. Sent from your administrative browser.<\/li>\n
                  • What is sent: Up to 100 approved comments from your site \u2014 for each: its comment ID, the post it's on, the post title, the commenter's display name, and the comment content \u2014 read from your own site's WordPress REST API.<\/li>\n
                  • Why: To surface which product categories your audience is already discussing in comments, so you know where to add a quiz.<\/li>\n<\/ul>\n\n
                    By using this plugin, you agree to the Decision Widget Terms of Service and Privacy Policy:<\/p>\n\n
                      \n
                    • Terms of Service: https:\/\/www.decisionwidget.net\/terms<\/li>\n
                    • Privacy Policy: https:\/\/www.decisionwidget.net\/privacy<\/li>\n<\/ul>\n\n\n
                        \n
                      1. Install: Go to Plugins \u2192 Add New \u2192 search \"Decision Widget\" \u2192 Install \u2192 Activate<\/li>\n
                      2. Activate: Go to Settings \u2192 Decision Widget \u2192 click \"Activate \u2014 Start Embedding Quizzes\"<\/li>\n
                      3. Add to a post: Open any post \u2192 click \"+\" \u2192 search \"Decision\" \u2192 add the Decision Widget block \u2192 pick a category \u2192 Publish<\/li>\n<\/ol>\n\n
                        That's it. Three clicks from install to live quiz. No account needed, no configuration, no code.<\/p>\n\n
                        For detailed help, see the \"How to Use\" guide inside the plugin settings page.<\/p>\n\n\n
                        \n
                        Is it free?<\/h3><\/dt>\n
                        Yes \u2014 unlimited categories, unlimited embeds, no credit card. Upgrade to Growth ($29\/mo) to route commissions to your own affiliate tags.<\/p><\/dd>\n
                        Do I need an affiliate account?<\/h3><\/dt>\n
                        Only on Growth tier ($29\/mo). We support multiple affiliate networks \u2014 Amazon Associates is the most common, with specialty retailers and other networks routed where applicable. The free tier works without any affiliate account.<\/p><\/dd>\n
                        How many quizzes can I embed?<\/h3><\/dt>\n
                        Unlimited. Embed as many different categories as you want across your entire site.<\/p><\/dd>\n
                        Does it slow down my site?<\/h3><\/dt>\n
                        No. The quiz loads in a lightweight iframe with lazy-loading and doesn't affect your page speed score or Core Web Vitals.<\/p><\/dd>\n
                        What data is sent to Decision Widget?<\/h3><\/dt>\n
                        Your site URL and Partner ID for click attribution. No visitor personal data is collected or transmitted. See our privacy policy for details.<\/p><\/dd>\n
                        What categories are available?<\/h3><\/dt>\n
                        359 categories covering electronics, kitchen, fitness, outdoor, home, office, audio, photography, gaming, and more. New categories are added regularly.<\/p><\/dd>\n
                        What if Decision Widget's server is down?<\/h3><\/dt>\n
                        The plugin gracefully shows a \"temporarily unavailable\" message with a link to view recommendations on decisionwidget.net. Your page layout is never broken.<\/p><\/dd>\n\n<\/dl>\n\n\n
                        1.1.0<\/h4>\n\n
                        Major upgrade to the flagship feature set, with full WordPress.org compliance applied throughout.<\/p>\n\n
                        New features:\n* Four embed modes \u2014 Full Quiz, Inline CTA, Compact Card, Versus\n* Mode tab selector on the settings page with live shortcode preview\n* Mode dropdown in the Gutenberg block inspector\n* Live preview modal for each embed mode\n* \"How to Use\" expandable in-product guide with Gutenberg + shortcode instructions\n* Common Questions FAQ section\n* \"Other Platforms\" HTML snippet generator (Blogger, Ghost, Substack, Squarespace, Wix, Webflow, plain HTML)\n* Performance dashboard with embed loads, affiliate clicks, and estimated commission value (based on industry-standard affiliate metrics applied to your measured traffic)\n* Post & Page Scanner \u2014 reads your archive and suggests which posts to embed, with one-click shortcode copy\n* Conversation Insights \u2014 mines approved comments to surface which categories your audience is already discussing\n* Deactivation feedback modal (with optional email opt-in for product updates)\n* Embed load tracking\n* Auto-height per mode<\/p>\n\n
                        Architecture and compliance:\n* All inline JavaScript moved to separate files in assets\/ (admin-deactivate.js, admin-settings.js, block.js)\n* Hook-gated script enqueueing \u2014 admin assets only load on plugins.php and the plugin's settings page\n* All user-facing strings flow through wp_localize_script for full i18n support\n* Plugin-prefixed identifiers throughout (deciwid_ \/ DECIWID_)\n* Nonce verification on every $_GET \/ $_POST handler, with wp_unslash + sanitize_key \/ sanitize_text_field\n* No direct database queries \u2014 all uninstall cleanup uses the WordPress API\n* Top-level variables in uninstall.php carry the plugin prefix\n* Complete External Services documentation for all 6 outbound endpoints<\/p>\n\n
                        (Supersedes 1.0.x.)<\/p>\n\n
                        1.0.0<\/h4>\n\n
                          \n
                        • Initial release<\/li>\n
                        • Shortcode and Gutenberg block support<\/li>\n
                        • 3-step setup wizard with explicit consent<\/li>\n
                        • Category browser with search<\/li>\n
                        • Light, dark, and auto themes<\/li>\n
                        • Graceful fallback when server is unreachable<\/li>\n
                        • Full internationalization support<\/li>\n
                        • Uninstall cleanup<\/li>\n<\/ul>","raw_excerpt":"Turn any blog post into an interactive product recommendation engine. 359 categories, 9,000+ products, live retailer deals. Free forever.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/303590","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=303590"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/joelchouinard"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=303590"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=303590"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=303590"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=303590"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=303590"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=303590"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}