Skip to main content

Quick Start — WooCommerce

Get ShopperQuiz running on your WooCommerce store in under 15 minutes.

What you'll need​

  • A WordPress site with WooCommerce installed
  • A ShopperQuiz account — sign up at app.shopper-quiz.com
  • WooCommerce REST API keys (you'll generate these in step 1)

Step 1 — Generate your WooCommerce API keys​

ShopperQuiz connects to your WooCommerce store using REST API keys. To generate them:

  1. In your WordPress admin, go to WooCommerce → Settings → Advanced → REST API
  2. Click Add key
  3. Give it a description (e.g. "ShopperQuiz"), set permissions to Read/Write, and click Generate API key
  4. Copy the Consumer Key and Consumer Secret — you'll need both in the next step

Keep this page open or save the keys somewhere safe. The Consumer Secret is only shown once.

Step 2 — Connect your store​

  1. Sign up or log in at app.shopper-quiz.com
  2. Go to Integrations in the sidebar
  3. In the WooCommerce card, enter:
    • Your WordPress site URL (e.g. https://yourstore.com)
    • Your Consumer Key (ck_…)
    • Your Consumer Secret (cs_…)
  4. Click Connect WooCommerce

ShopperQuiz will verify the credentials and connect your store. Your products, categories, and tags will start syncing in the background — this usually takes under a minute.

Step 3 — Build your first quiz​

  1. Click Quizzes in the sidebar, then New quiz
  2. Give your quiz a name and you'll land in the Quiz Builder

From here:

  • Edit the Welcome Screen — heading, description, optional image
  • Add questions using the + button in the left panel
  • For each answer, assign votes to the products, categories, or tags that best match
  • Configure the Results Screen — layout, button text, and how many products to show

If this is your first time, start with 3–5 questions. You can always add more later.

Step 4 — Add the quiz to your store​

Get your Quiz ID

Open your quiz in the Quiz Builder and click Quiz Settings — the Quiz ID is shown there. You can also copy it from the URL in your browser while on the Quiz Builder page.

Embed using a shortcode

Add the quiz to any page or post using the ShopperQuiz shortcode:

[shopperquiz id="your-quiz-id"]

Replace your-quiz-id with the ID you copied. The quiz will render wherever the shortcode is placed.

We recommend placing the quiz on its own dedicated page so it has the full content area to itself.

Embed using the Gutenberg block

If you use the WordPress block editor, search for the ShopperQuiz block, add it to your page, and enter your Quiz ID in the block settings.

Step 5 — Test it​

Visit the page where you embedded the quiz and take it as a shopper would. Check that questions and answers display correctly, results show the products you expect, and the Add to cart button works.

If results aren't what you expect, revisit your vote assignments in the builder. The right panel shows each product's total accumulated votes across the entire quiz.

You're live​

As shoppers complete the quiz, their responses appear in Analytics and Responses in your ShopperQuiz dashboard.

Next steps​

Was this page helpful?