Skip to main content

How to Create a Quiz from Scratch

Use New Quiz in AtomicQuiz when you want full control over every step, question, and result page — without starting from a template or cloning another quiz URL.

This guide covers the blank-quiz workflow from creation through your first saved draft.

Before You Start​

Make sure you have:

  • Access to AtomicQuiz (Quizzes area) in your workspace.
  • At least one site created so the quiz can publish to a domain. See Sites overview.
  • A rough outline of quiz steps (intro, questions, result, optional form).
  • Permission to save and publish quizzes on your plan.

Quizzes are tied to a site like pages, so pick the site that matches your campaign domain before you build.

Step 1: Open AtomicQuiz​

  1. Log in to Atomicat.
  2. Open AtomicQuiz from the sidebar (Quizzes area).
  3. Review the quiz list — this is where published and draft quizzes appear later.

See Quizzes overview for how quizzes fit with pages, funnels, and leads.

Step 2: Start a New Quiz​

  1. Click New Quiz (or equivalent New action on the quizzes list).
  2. Enter a Quiz name — this is the team-facing label in your list. Visitors see titles you set inside each step in the builder.
  3. Select the Site where the quiz will publish.
  4. Confirm to open the quiz editor.
FieldWhy it matters
Quiz nameHelps your team find the quiz in AtomicQuiz and in integrations.
SiteConnects publishing, domain, and slug to the correct destination.

If site selection is missing or blocked, create a site first or check plan permissions.

Step 3: Understand the Editor Layout​

The Quiz Builder is the default editing mode:

AreaWhat you do
Steps railSelect which step you are editing; add or reorder steps.
Blocks libraryDrag components (text, media, buttons, quiz blocks) onto the canvas.
CanvasLayout for the current step; click elements to select them.
Edit panelContent, style, and advanced settings for the selected element.

Use Save regularly. Preview opens the quiz in a new tab for click testing before publish.

See Quiz Builder for the full editor reference.

Step 4: Add and Name Steps​

  1. In the steps rail, add a new step for each screen in the journey (welcome, Q1, Q2, result, etc.).
  2. Give each step a clear internal name so Flow mode stays readable later.
  3. Keep each step focused on one decision when possible — long single steps reduce completion rates.

Typical scratch structure:

  • Intro — headline, short explanation, start button.
  • Question steps — one or two questions per step.
  • Result — offer, summary, or CTA.
  • Optional capture — form or redirect button.

Step 5: Add Blocks to Each Step​

  1. Select a step in the rail.
  2. From the blocks library, drag elements onto the canvas (text, images, buttons, quiz option blocks, etc.).
  3. Click an element to open the edit panel.
  4. Fill in copy, media, and required settings.
  5. Repeat for every step in the journey.

After structural changes, open Flow to confirm paths between steps make sense.

Step 6: Save and Preview​

  1. Click Save in the header.
  2. Note the last saved time when shown.
  3. Click Preview and walk through every path you expect visitors to take.
  4. Fix dead ends or missing buttons before publishing.

Nothing is live until you publish to a URL on your site.

Best Practices​

  • Name steps for Flow readability (Offer, Q1 – goal, Result A).
  • Test on mobile in Preview — quiz layouts often break on small screens first.
  • Wire webhooks and tracking in Settings after core content works.
  • Use Design mode later for visual polish, not before structure is stable.

Troubleshooting​

ProblemWhat to try
Cannot select a siteCreate a site in Sites; confirm plan access.
Blocks will not dropCheck step is selected; some blocks cannot stack in the same target.
Preview shows empty stepSave first; confirm blocks are on the active step canvas.
Two quiz options conflictProduct may block duplicate quiz options in the same target — use separate containers or steps.

Outcome​

You have a new quiz document built from scratch in AtomicQuiz — steps, blocks, and saved content ready for Flow tuning, webhooks, and publishing.

FAQ​

Can I create a quiz without choosing a site?

You need a site so the quiz can publish under a domain you control or your Atomicat domain, depending on setup.

What is the difference between New Quiz and Browse Templates?

New Quiz starts blank. Templates open a pre-built quiz you customize. See How to create a quiz from a template.

Is the quiz live after I save?

No. Save keeps your draft. Publish makes the quiz available at a public URL.

Where do I set branching between steps?

Configure navigation per element in Builder, then review and edit links in Flow mode.

Can I clone someone else's quiz instead?

Clone Quiz copies from a public quiz URL when your plan supports it. Some URLs require AtomicMCP instead.