# How to use Snacked

Snacked turns a one-sentence brief into a complete AI quiz funnel — questions, archetypes, scoring, result copy — that captures emails tagged by personality. This guide walks you from signup to your first live quiz, and then through every feature you'll grow into.

If you prefer to skim, jump to a section below. If you'd rather feed this to your favourite LLM, the same content is available at `/guide.md`, and a machine-readable index lives at `/llms.txt`.

## Table of contents

- [What Snacked is, in one minute](#what-snacked-is)
- [Sign up and the dashboard](#sign-up)
- [Create your first quiz with AI](#create-your-first-quiz)
- [Edit anything the AI produced](#edit-anything)
- [The scoring matrix, demystified](#scoring-matrix)
- [Theme and brand your quiz](#theme-and-brand)
- [Publish and share](#publish-and-share)
- [Connect your email tool](#integrations)
- [Add branching logic](#branching)
- [Embed your quiz anywhere](#embed)
- [Track conversions](#tracking)
- [Manage and export leads](#leads)
- [Plans, limits and billing](#plans)
- [Languages](#languages)
- [Troubleshooting](#troubleshooting)
- [What's next](#whats-next)

## What Snacked is, in one minute {#what-snacked-is}

Snacked is an AI-first quiz funnel builder for creators, marketers and founders who use lead magnets to grow an email list. Where a PDF gets downloaded and forgotten, a quiz feels like a conversation — and converts.

You describe your audience in one sentence. Snacked generates 8 to 12 single-choice questions, five distinct psychographic archetypes, a full scoring matrix and personalised result copy. You edit anything, publish to a sharable URL or embed it on your own site, and every completion drops an email into your existing ESP — already tagged by archetype.

Snacked is intentionally niche-agnostic. Whether you sell fitness coaching, B2B software, online courses or hand-thrown ceramics, the same builder works.

## Sign up and the dashboard {#sign-up}

Sign up at [snacked.it](https://snacked.it) with email or a third-party identity provider. No credit card required — the Free plan stays free for three published quizzes.

After signup you land on your **dashboard**. From here you can:

- Create a new quiz (button top-right)
- Open any existing quiz to edit, view leads or change settings
- Open **Settings** to manage your account, billing, branding defaults and integrations
- Open **Refer** to share your referral link

If you ever lose your way, the Snacked logo in the header always takes you back to the dashboard.

## Create your first quiz with AI {#create-your-first-quiz}

Click **New quiz**. You'll see a single form with three inputs:

1. **Describe your audience and what you want to learn.** One or two sentences. Specific beats clever. Example: *"Solo founders launching their first SaaS who don't know if they should hire a marketer or do it themselves."*
2. **Pick a tone.** Playful, professional, bold or warm. This drives the voice of every question and the result copy.
3. **Pick a language.** Snacked respects your choice end-to-end — questions, archetypes, result copy and even the call-to-action button labels are all generated in the language you select.

Hit **Generate**. Claude Sonnet 4.6 (via the Vercel AI Gateway) streams the quiz live: title, questions, options, five archetypes, a full scoring matrix and personalised result copy for each archetype. You watch it appear in real time.

Most quizzes are usable as-is. But everything is editable — keep reading.

## Edit anything the AI produced {#edit-anything}

Open any quiz from your dashboard. The editor has five tabs:

### Content

The question list. For each question you can edit the text, edit each option's text, add or remove options, drag to reorder, or delete the question entirely. Add a new question with the **+ Add question** button at the bottom. Snacked supports 3 to 12 questions per quiz — fewer feels rushed, more loses people.

### Archetypes

The five result personalities. Each archetype has:

- **A title** (the headline result the user sees: *"The Strategic Operator", "The Brand Storyteller"*)
- **Result copy** in markdown — this is the personalised page they see after completion. Bold, italics, lists and links all work
- **A reward URL** (optional) — where the **Get your reward** button on the result page sends them

You can rename, rewrite, swap rewards. You can't currently have fewer than five archetypes — the quiz logic and scoring assume five.

### Scoring

The scoring matrix. **This is the heart of the quiz** — see the next section for how to think about it.

### Theme

Per-quiz colours, fonts and presets. Covered in [Theme and brand your quiz](#theme-and-brand) below.

### Settings

Per-quiz settings: title, description, social preview image, integrations, branching rules, tracking pixels, embed code.

## The scoring matrix, demystified {#scoring-matrix}

Every answer to every question contributes to every archetype. If a user picks option B on question 3, that single choice nudges their score on all five archetypes, not just one.

Concretely: each option has five numeric weights (one per archetype). At the end of the quiz, Snacked sums the weights for the picks the user made and the archetype with the highest score wins.

**The hard rule:** every option must have a weight for every archetype. No gaps, no zeros-by-default. If the AI returns a sparse matrix, the generation fails and you regenerate — by design, to keep results meaningful.

You don't need to tweak the matrix to get a great quiz out of the door. But once you have data on which results are dominating, you can rebalance weights from the **Scoring** tab to push more users toward under-represented archetypes — useful if one archetype maps to your highest-converting offer.

## Theme and brand your quiz {#theme-and-brand}

Every quiz has its own theme so a single account can host multiple brands. The **Theme** tab gives you:

- **Four built-in presets:** Sprout (mint + warmth), Midnight (deep ink, high contrast), Sunset (coral gradients), Mono (black on white). One click and the entire quiz repaints.
- **Custom colours.** Set your primary, background and accent colours. The result page picks up the same palette.
- **Custom font.** Pick from a curated list of Google Fonts, or paste your own font URL.
- **Logo.** Upload your logo for the quiz header.
- **Social preview.** Upload a custom Open Graph image for when the quiz URL is shared on social.

Free accounts always show a small *"Build your own AI quiz — try Snacked"* badge on the result page. Pro removes it.

## Publish and share {#publish-and-share}

When you're ready, hit **Publish**. The quiz becomes live at a public URL:

```
snacked.it/<your-handle>/<your-quiz-slug>
```

The handle and slug are editable from **Settings → URL**. You can republish edits at any time without changing the URL or breaking links you've already shared.

Share the URL in your bio, in newsletters, in social posts. Or embed it — see [Embed your quiz anywhere](#embed) below.

## Connect your email tool {#integrations}

Open **Settings → Integrations** on any quiz to connect:

- **Klaviyo** — list + per-archetype tags
- **ConvertKit** — sequence + per-archetype tags
- **Mailchimp** — audience + per-archetype tags
- **MailerLite** — group + per-archetype tags
- **Brevo** (Pro) — list + per-archetype tags
- **Zapier** — every completion fires a webhook into your Zap
- **Custom webhook** — every completion `POST`s a JSON payload to a URL you control

Each completion sends the lead's email, archetype, full set of answers, quiz ID, and any UTM parameters present at the time of capture. The archetype is sent both as a string and as a tag, so segmenting your list is one filter.

Free plan ships Zapier and custom webhook. Pro unlocks all the native ESPs, including Brevo.

## Add branching logic {#branching}

Pro feature. From the editor's **Branching** tab you can attach rules to any option:

- **Jump to question** *(skip ahead)*
- **End the quiz** *(go straight to a specific archetype's result, e.g. a disqualifier path)*

Branching is useful for two cases. First, **qualifiers**: ask *"Do you have a website?"* and route "No" straight to a starter-tier result. Second, **personalisation**: skip irrelevant questions for users who already self-identified earlier.

Keep branching minimal at first. A 6-question linear quiz with a tight scoring matrix beats a 14-question branching maze.

## Embed your quiz anywhere {#embed}

Pro feature. The **Embed** page on any quiz gives you three snippets:

- **Inline iframe** — paste into any HTML, sized to your container
- **Popup** — a button anywhere on your site opens the quiz in a modal
- **Floating button** — a corner button persistently invites visitors to take the quiz

All three pass UTM parameters from the host page through to the lead record, so attribution survives the embed.

## Track conversions {#tracking}

In **Settings → Tracking** on any quiz, paste:

- **Meta Pixel ID** — page views, quiz starts and lead events fire client-side
- **Conversions API token** — the same lead events fire server-side with event deduplication, so iOS 14+ and ad-blocked users still count
- **GA4 measurement ID** — Google Analytics 4 events for the funnel

Pro feature. Add the IDs once, see attributed leads end-to-end. No tag manager required.

## Manage and export leads {#leads}

Every completion creates a lead record visible under the quiz's **Leads** tab. For each lead you see:

- Email
- Assigned archetype
- All answers
- Completion time
- UTM parameters at capture
- Whether they clicked through to the reward URL

Export the full list as CSV at any time from the **Export** button. The CSV is also a clean format for one-off imports into a CRM that we don't yet integrate with.

Free plan captures up to **1,000 lifetime leads** across all quizzes — beyond that, leads are still captured but locked from view until you upgrade. Pro lifts the cap to 10,000 / month.

## Plans, limits and billing {#plans}

| Feature | Free | Pro | Pro Lifetime |
| --- | --- | --- | --- |
| Published quizzes | 5 | 10 | 10 |
| Leads | 1,000 lifetime | 10,000 / mo | 10,000 / mo |
| AI generations | 15 / mo | 50 / mo | 50 / mo |
| Integrations | Zapier + webhook | All ESPs incl. Brevo | All ESPs incl. Brevo |
| Branching, embed, tracking | — | ✓ | ✓ |
| Watermark removed | — | ✓ | ✓ |
| Price | $0 | $19/mo annual · $29/mo monthly | $499 one-time |

Billing is handled through Paddle as Merchant of Record. Upgrade and downgrade any time from **Settings → Billing**. Cancellations take effect at the end of your current billing cycle — you keep Pro features until then. Customers in the EU/EEA/UK/Switzerland are entitled to a full refund within **14 days from the date of purchase** per Paddle's [Refund Policy](https://www.paddle.com/legal/refund-policy).

## Languages {#languages}

The AI follows whatever language you pick at generation time. The dashboard UI is English for now, but every public surface a quiz-taker sees — questions, archetypes, result copy, button labels, error messages — uses the language you generated in.

You can have multiple quizzes in different languages on the same account.

## Troubleshooting {#troubleshooting}

**Generation failed midway.** The scoring matrix integrity check rejected the output. Just hit **Regenerate** — failures are rare and idempotent.

**The AI ignored part of my brief.** Try one of two things: tighten the brief (shorter, more specific) or generate, then edit. The editor is the source of truth — the AI is the rough draft.

**My ESP isn't connecting.** Double-check the API key permissions. For Klaviyo and Brevo, the key needs at minimum the list/contact write scopes. If it still fails, send the error message to [support@snacked.it](mailto:support@snacked.it) — we keep a per-provider runbook.

**The embed iframe is too tall / too short.** The quiz auto-resizes via `postMessage` to the parent. Make sure your container doesn't have a fixed height; let it grow.

**Leads are coming through but not tagged by archetype.** Re-check that the archetype field is mapped in your ESP integration setup. Some providers (notably Mailchimp) require the destination tag field to exist before sync starts.

## What's next {#whats-next}

- **[Take the live demo quiz](https://snacked.it/snacked/what-kind-of-digital-marketer-are-you-really)** built with Snacked, on Snacked
- **[See pricing](https://snacked.it/pricing)** including the Pro Lifetime offer
- **[Read the FAQ](https://snacked.it/faq)** for shorter answers to common questions
- **Email [support@snacked.it](mailto:support@snacked.it)** for anything we haven't covered

Snacked is built by a small team that ships fast. If something feels off, tell us — most weeks at least one user-reported friction makes it into the next release.
