Docs

Documentation

Everything you need to build quizzes, capture leads, and connect your email platform.

Getting Started

Creating your account

Sign up for a free 14-day trial at app.testy.io/register. No credit card required.

  1. 1 Enter your name, email, and a password to create your account.
  2. 2 You'll land on your dashboard where you can create your first quiz immediately — no setup wizard required.
  3. 3 Your free trial lasts 14 days. You won't be charged until you choose a paid plan.

Building your first quiz

From your dashboard, click New Quiz to get started. You can pick a template or start from scratch. The quiz builder has three tabs:

Questions

Add, reorder, and edit quiz questions. Each question can have multiple answer choices with optional images.

Outcomes

Define the results your quiz can show and map answer weights to each outcome.

Settings

Configure lead capture (email gate), quiz type, and branding options.

Publishing your quiz

When your quiz is ready, click the Publish button in the top-right corner of the quiz builder. Your quiz goes live immediately. You can unpublish at any time to take it back to draft status.

Note: The embed snippet and hosted link only work after you publish. Draft quizzes return a 404 to visitors.

Quiz Types

Personality Quiz

Personality quizzes map each answer choice to outcomes using weights. At the end, the outcome with the highest total weight wins.

How scoring works: For each answer choice, you assign a weight (0–10) for each outcome. When a visitor completes the quiz, Testy tallies the weights across all selected answers and shows the outcome with the highest cumulative score.

Common uses

  • "What type of entrepreneur are you?"
  • "What's your content marketing style?"
  • "Which of our programs is right for you?"

Scored Assessment

Scored assessments assign point values to each answer choice. The visitor's total score determines which outcome (score band) they land in.

How scoring works: Each answer choice has a point value. You define outcomes as score ranges — for example, 0–30 = "Beginner", 31–70 = "Intermediate", 71–100 = "Expert". Testy sums the points and shows the matching outcome.

Common uses

  • Knowledge tests and certifications
  • Readiness assessments ("Are you ready to launch?")
  • Health and fitness quizzes

Product Recommender

Product recommenders work like personality quizzes but are optimized for commerce. Each outcome represents a product or service. Answer weights steer visitors to the most relevant recommendation.

Common uses

  • "Find your perfect skincare routine"
  • "Which plan should I choose?"
  • "What supplement is right for me?"

Lead Capture

Enabling lead capture

To collect emails, open the Settings tab in the quiz builder and enable Lead Capture. You can choose when to show the email form:

Before results (gate)

Visitors must enter their email to see their result. Delivers the highest capture rate, but expect some drop-off from visitors who decline.

After results (opt-in)

Results are shown first, then visitors are invited to sign up. Lower friction for the visitor, lower capture rate overall.

You can also mark the email field as required or optional, and set a custom CTA label (e.g., "Get your full analysis") to increase signups.

Outcome-based tagging

When configuring an integration, you can assign a tag to each quiz outcome. When a lead is captured, Testy automatically applies the tag that matches their result in your email platform — enabling segmented follow-up sequences.

For example, if your quiz has outcomes "Beginner", "Intermediate", and "Expert", you can map them to tags like quiz-beginner, quiz-intermediate, and quiz-expert.

Tip: Outcome tags are one of the most powerful features in Testy. Use them to trigger different email automations for each quiz result.

Integrations

To connect an integration, open your quiz and click Integrations in the quiz navigation, then click Add integration. Leads sync automatically whenever a visitor completes the quiz and submits their email. You can connect multiple integrations to the same quiz.

Mailchimp

Subscribe leads directly to a Mailchimp audience.

Required credentials

API Key Found in Mailchimp under Account & billing → Extras → API keys. The key includes your data center, e.g. xxxxxxxx-us21.
Audience ID Found in Mailchimp under Audience → All contacts → Settings → Audience name and defaults. Listed as "Audience ID".

Kit (ConvertKit)

Add leads as subscribers to a Kit form with optional outcome-based tags.

Required credentials

API Secret Found in Kit under Settings → Advanced → API Secret. Use the secret key, not the public API key.
Form ID The numeric ID of the form to subscribe leads to. Found in the form's URL: app.kit.com/forms/1234567.
Tags entered in the outcome mapping are created in Kit automatically if they don't already exist.

Klaviyo

Subscribe leads to a Klaviyo list with optional outcome-based tags applied as profile properties.

Required credentials

Private API Key Found in Klaviyo under Account → Settings → API Keys → Create Private API Key. Must be a private key starting with pk_.
List ID Found in Klaviyo under Lists & Segments. Click your list → Settings to find the ID (e.g., AbCdEf).

ActiveCampaign

Create or update contacts in ActiveCampaign and optionally add them to a list.

Required credentials

Account URL Your ActiveCampaign account URL, e.g. https://youraccountname.api-us1.com. Found in Settings → Developer.
API Key Found in ActiveCampaign under Settings → Developer → API Key.
List ID Optional. The numeric ID of a list to add contacts to. Found in Lists → Settings.

Flodesk

Subscribe leads to Flodesk, optionally placing them into a segment.

Required credentials

API Key Found in Flodesk under Account → Integrations → Flodesk API.
Segment ID Optional. The ID of a Flodesk segment to add subscribers to.

MailerLite

Add leads as subscribers to your MailerLite account.

Required credentials

API Key Found in MailerLite under Integrations → MailerLite API → Generate new token.
Group ID Optional. Add subscribers to a specific group. Found in Subscribers → Groups.

GoHighLevel

Create contacts in a GoHighLevel sub-account from quiz leads.

Required credentials

API Key Found in GoHighLevel under Settings → Business Profile → API Key.
Location ID The sub-account (location) ID to create contacts in. Found in the URL when viewing a sub-account: app.gohighlevel.com/location/loc_….

Drip

Subscribe leads to Drip as subscribers and apply optional tags per outcome.

Required credentials

API Key Found in Drip under User Settings → API Token.
Account ID Your Drip numeric account ID. Found in the URL after logging in: app.getdrip.com/1234567/.

Webhook

Send lead data to any URL via HTTP POST. Use this to connect Testy to Zapier, Make (Integromat), n8n, or any custom backend endpoint.

Required credentials

Webhook URL The URL Testy will POST lead data to whenever a lead is captured.
Signing Secret Optional. If provided, each request will include an X-Testy-Signature header containing an HMAC-SHA256 signature of the payload, so you can verify requests are genuine.

Payload format

{
  "email": "[email protected]",
  "quiz_title": "What type of marketer are you?",
  "outcome_title": "The Storyteller",
  "captured_at": "2025-10-01T14:32:00Z"
}

Embedding & Sharing

Embed snippet

Copy your quiz's embed snippet from Share & Embed inside the quiz builder, then paste it anywhere you want the quiz to appear on your site. 

<div id="testy-quiz" data-quiz-id="your-quiz-slug"></div>
<script src="https://cdn.testy.io/widget.js" async></script>

The widget renders inline wherever you place the <div>. It is fully responsive and adapts to any container width.

WordPress

Add a Testy quiz to any WordPress page or post using the Custom HTML block.

  1. 1 In the WordPress block editor, click + to add a block and search for Custom HTML.
  2. 2 Paste your quiz embed snippet into the block.
  3. 3 Click Update or Publish. The quiz will appear live on your page.

Shopify

Embed a Testy quiz on any Shopify page via the page editor's HTML mode.

  1. 1 In your Shopify admin, go to Online Store → Pages and open the target page.
  2. 2 Click the <> (source code) icon in the editor toolbar to switch to HTML mode.
  3. 3 Paste the embed snippet and click Save.

Webflow

Use Webflow's built-in Embed element to add a Testy quiz to any page or section.

  1. 1 In the Webflow Designer, drag an Embed element onto your page from the Add Elements panel.
  2. 2 Paste the Testy embed snippet into the HTML code editor that opens.
  3. 3 Click Save & Close, then publish your site.

Analytics

Reading your data

Open any quiz and click the Analytics tab to view performance data. Stats update in real time as visitors complete your quiz.

Views

Total number of times the quiz was loaded by a unique visitor.

Completions

Number of visitors who answered all questions and reached a result.

Leads captured

Number of completions where the visitor submitted their email address.

Outcome breakdown

Distribution of which results your visitors received, shown as a percentage of total completions.

The Leads tab shows a full table of every email captured, including the outcome the visitor received and the capture date. You can use this for manual export or to cross-reference against your email platform.

Can't find what you're looking for? Email us at [email protected]