← Back to Builder

User Guide

Everything you need to know to create beautiful, high-converting quizzes.

🚧 Beta Notice: The St. Cupertino Quiz Generator is currently in beta. We're actively improving features, squashing bugs, and adding new capabilities. Your feedback helps shape the product — reach out to contact@marymilagros.com with questions, issues, or ideas.

Getting Started

The St. Cupertino Quiz Generator lets you create beautiful, branded quizzes in minutes. Here's a quick overview of the 7-step process:

  1. Mode — Choose your quiz type and how results are calculated
  2. Content — Set your quiz title, description, and welcome screen
  3. Design — Customize colors, fonts, and styling
  4. Questions — Add your questions and answer options
  5. Results — Create result pages for each outcome
  6. Lead Capture — Optionally collect emails before showing results
  7. Generate — Get your embed code or host your quiz
Pro Tip: Your quiz auto-saves as you work. You can close the browser and come back later — your progress will be there.

Quiz Modes Explained

Simple Scoring

Each answer is assigned to a result. The result with the most matching answers wins. Perfect for personality quizzes like "What Type of Entrepreneur Are You?" or "Which Coffee Drink Matches Your Personality?"

Branching Paths

Each answer leads directly to a specific result, regardless of other answers. Great for recommendation quizzes, assessments, or diagnostic tools where the path matters more than accumulating points.

Results Display

Building Your Quiz

Questions

Add as many questions as you need. For each question:

Best Practice: Keep quizzes to 5-10 questions. Shorter quizzes have higher completion rates.

Results

Create compelling result pages that:

Styling & Design

Style Presets

Choose from 24 professionally designed presets across categories:

Custom Styling

Fine-tune every aspect:

Theme Modes

The builder includes three visual themes. Click the theme toggle in the sidebar to switch:

AI Quiz Generation

Let AI create your entire quiz in seconds:

  1. Click AI Generate in the sidebar
  2. Describe your quiz topic and audience
  3. Choose the number of questions and results
  4. Click Generate and watch the magic happen
Note: AI generation requires a paid account. You get 5 AI-generated quizzes with your purchase.

Lead Capture Setup

Collect emails before showing results to build your list:

  1. Go to Step 6: Lead Capture
  2. Toggle "Require Form Submission" on
  3. Choose your form type:
    • Built-in Form — Simple name/email capture
    • Embed Code — Paste your Mailchimp, ConvertKit, or other form embed
  4. Customize the form page title and subtitle

Embedding Your Quiz

Standard Embed

Works on most platforms (Squarespace, WordPress, Showit, etc.):

  1. Go to Step 7: Generate
  2. Copy the HTML code
  3. Paste into your website's HTML/embed block

Wix & Restricted Platforms

Some platforms block JavaScript. Use our hosted solution instead:

  1. Click "Host My Quiz" in the Generate step
  2. Publish your quiz to get a hosted URL
  3. Use an iframe embed or link directly to the hosted quiz
<iframe src="https://quizgenerator.marymilagros.com/q/YOUR-QUIZ-ID" 
  width="100%" height="600" frameborder="0"></iframe>

Quiz Hosting

Host up to 10 quizzes on our servers (paid accounts only):

  1. Build your quiz
  2. Click "Host My Quiz" in Step 7
  3. Give it a name and click Publish
  4. Get your shareable link and embed codes

Managing Hosted Quizzes

Click "Hosted Quizzes" in the sidebar to:

Troubleshooting

Quiz not displaying?

Styling looks different on my site?

Your site's CSS might be conflicting. Try:

Lost your work?

Quizzes auto-save to your browser. If you cleared your browser data, check "My Quizzes" in the sidebar — previously saved quizzes appear there.

Need more help?

Email us at contact@marymilagros.com and we'll get back to you within 24 hours.