> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# quiz_completed Event

> Track when a visitor completes a quiz or assessment

Fires when a visitor completes a quiz, product recommendation quiz, or assessment. This is a recommended custom event for tracking quiz funnels and product discovery flows.

<Note>
  **Custom Event** — This event is not automatically tracked. Fire it manually using the JavaScript SDK when a quiz is completed.
</Note>

## JavaScript

```javascript theme={null}
window._upstack('track', 'quiz_completed', {
  quiz_id: 'skin-type-finder',
  quiz_name: 'Find Your Perfect Skincare Routine',
  result_id: 'oily-acne-prone',
  result_name: 'Oily & Acne-Prone Skin',
  questions_answered: 8,
  time_to_complete: 145,
  value: 25.00,
  currency: 'USD'
});
```

Quiz with product recommendations:

```javascript theme={null}
window._upstack('track', 'quiz_completed', {
  quiz_id: 'gift-finder',
  quiz_name: 'Holiday Gift Finder',
  result_id: 'tech-enthusiast',
  recommended_products: ['SKU-1234', 'SKU-5678', 'SKU-9012'],
  questions_answered: 5
});
```

## Properties

| Property              | Type      | Required | Description                                   |
| --------------------- | --------- | -------- | --------------------------------------------- |
| quiz\_id              | string    | Yes      | Unique identifier for the quiz                |
| quiz\_name            | string    | No       | Human-readable quiz title                     |
| result\_id            | string    | No       | Identifier for the quiz result or outcome     |
| result\_name          | string    | No       | Human-readable result description             |
| questions\_answered   | number    | No       | Total questions completed                     |
| time\_to\_complete    | number    | No       | Seconds from quiz start to completion         |
| recommended\_products | string\[] | No       | Array of product SKUs recommended by the quiz |
| value                 | number    | No       | Estimated value of the quiz completion        |
| currency              | string    | No       | ISO 4217 currency code                        |

## When to Fire

* Product recommendation quiz completion
* Skin type or style finder completion
* Gift guide quiz completion
* Assessment or diagnostic quiz completion
* Personality quiz completion

## Destination Support

| Destination           | Support                                                                           |
| --------------------- | --------------------------------------------------------------------------------- |
| **Meta CAPI**         | Supported as `Custom` event type. Use for building audiences of quiz completers.  |
| **TikTok Events API** | Supported. Use for audience building.                                             |
| **Klaviyo**           | Fully supported. Triggers flows based on quiz results for personalized follow-up. |
| **GA4**               | Supported. Maps to custom event with parameters.                                  |
| **Webhook**           | Fully supported. Raw payload forwarded.                                           |

<Tip>
  **Personalization tip:** Pass the `result_id` to Klaviyo to trigger personalized email flows based on quiz outcomes. Segment customers by their quiz results for targeted product recommendations.
</Tip>

## Related Events

* [quiz\_question\_answered](/pixel/events/quiz-question-answered) — Track individual question responses
* [lead](/pixel/events/lead) — For capturing contact info during or after quiz
* [view\_content](/pixel/events/view-content) — When quiz results include product views