# Product Recommendation Quiz

The Product Recommendation Quiz lets you create interactive quizzes that guide customers to the right products based on their answers. Instead of browsing through your catalog, customers answer a few simple questions and receive personalized product recommendations — helping them decide faster and increasing your conversion rate.

This feature is available on **all plans**, including stores that installed the app before pricing was introduced.

### How It Works

A quiz walks your customers through a guided experience:

1. **Welcome Page** — Greets the customer and invites them to start the quiz
2. **Questions** — A series of questions with answer options (text, vertical image, or horizontal image layouts)
3. **Email/Phone Capture** — Optionally collects the customer’s email or phone before showing results
4. **Result Page** — Displays personalized product recommendations based on the customer’s answers

Behind the scenes, the quiz uses **path-based result logic**: each combination of answers maps to a specific set of recommended products. If no path matches, fallback products are shown instead.

### What You Can Do

| Feature                     | Description                                                                                                                             |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Choose a template**       | Start from 5 ready-made templates (Skincare, Vitamin & Supplement, Clothing Fit & Style, Coffee Taste, Pet Food) or create a blank quiz |
| **3 answer layouts**        | Display answers as text only, vertical image (image above text), or horizontal image (image beside text)                                |
| **Path-based result logic** | Map each answer combination to a specific product list                                                                                  |
| **Fallback products**       | Set default recommendations when no path matches                                                                                        |
| **Welcome Page**            | Customize heading, description, image, and CTA button text                                                                              |
| **Email/Phone Capture**     | Collect customer emails and phone numbers before revealing results                                                                      |
| **Result Page**             | Customize heading, description, and product display with Add to Cart buttons                                                            |
| **2 embed methods**         | Add quiz via a direct link in your navigation menu, or embed using a Quiz ID in the theme editor                                        |
| **Response tracking**       | View quiz responses with product engagement data (clicked, added to cart, purchased)                                                    |
| **Custom branding**         | Change logo, colors, corner radius, background, and layout                                                                              |
| **Auto-fit theme**          | Quiz automatically adapts cart behavior to your Shopify theme                                                                           |

### Quiz Response Limits

Each plan includes a monthly quiz response limit:

| Plan    | Quiz Responses/Month |
| ------- | -------------------- |
| Free    | 50                   |
| Starter | 500                  |
| Growth  | 1,000                |
| Premium | Unlimited            |

A warning banner appears when you are within 10 responses of your monthly limit.

### Get Started

* [Create a Quiz](http://localhost:3000/docs/product-recommendation-quiz/create-quiz) — Choose a template and set up your questions
* [Set Up Result Logic](http://localhost:3000/docs/product-recommendation-quiz/result-logic) — Configure path-based product recommendations
* [Add Quiz to Your Store](http://localhost:3000/docs/product-recommendation-quiz/add-quiz-to-store) — Publish the quiz on your online store
* [View Quiz Responses](http://localhost:3000/docs/product-recommendation-quiz/view-responses) — Track customer answers and product engagement
* [Customize Quiz Design](http://localhost:3000/docs/product-recommendation-quiz/customize-design) — Brand your quiz with custom logo, colors, and layout