Troubleshooting
Common issues and solutions for MagicGPT Quiz Builder for Forms.
Installation & Setup Issues
Can't Find Add-on in Google Forms
Symptoms: Add-on menu doesn't show MagicGPT Quiz Builder for Forms
Solutions:
- Refresh the Google Form page
- Clear browser cache and cookies
- Try a different browser
- Re-install the add-on
- Check if add-on is enabled in Google Workspace Admin (if using org account)
Add-on Won't Install
Possible Causes:
- Organization restrictions
- Browser extensions blocking
- Temporary Google service issue
Solutions:
- Check with IT admin if using work/school account
- Disable ad blockers temporarily
- Try incognito/private window
- Wait 1 hour and try again
- Contact support with error message
Permissions Issues
Symptoms: Add-on asks for permissions again or won't authorize
Solutions:
- Revoke permissions at myaccount.google.com/permissions
- Re-install add-on
- Grant all requested permissions
- Ensure you're using correct Google account
- Try different browser if persists
Free Trial Issues
Trial Counter Not Working
Symptoms: Still shows 3 trials after generating quiz
Possible Causes:
- Generation failed (didn't count)
- Browser cache issue
- Account sync problem
Solutions:
- Close and reopen the sidebar
- Refresh the form
- Check if questions were actually added
- If generation failed, it shouldn't count against trial
Used All Trials But Still Need to Test
Symptoms: Want to test more but used 3 trials
Solutions:
- Review the questions from your trials to evaluate quality
- Purchase lifetime license to continue
- Contact support if you experienced technical issues during trials
Generation Issues
"Please Set API Key" After Purchase
Symptoms: Purchased license but asked for API key
Explanation: This is expected behavior
Solution:
- Get OpenAI API key from platform.openai.com
- Open Settings in add-on
- Enter your API key
- Save and try generating again
- See API Configuration for detailed guide
Generation Takes Too Long
For AI Generation:
- Normal: 10-30 seconds
- If >1 minute: Refresh and try again
- Check internet connection
- Try simpler prompt
For Image to Quiz:
- Normal: 15-45 seconds
- Large images take longer
- Complex images take longer
- If >2 minutes: Cancel and retry
For PDF to Quiz:
- Normal: 30-90 seconds for 1-5 pages
- Large PDFs can take several minutes
- If stuck >5 minutes: Try smaller PDF
- Split large PDFs into smaller sections
Generation Fails / Error Message
Common Errors:
"Invalid API Key"
- Copy API key again (no spaces)
- Verify key at platform.openai.com
- Create new key if needed
- See API Configuration
"Insufficient Credits"
- Add payment method to OpenAI account
- Check billing at platform.openai.com
- Add credits if needed
"Request Failed"
- Check internet connection
- Try again in a few minutes
- Verify OpenAI service status
- Contact support if persists
"Rate Limit Exceeded"
- Wait 1-2 minutes
- Try again
- Don't generate multiple quizzes simultaneously
No Questions Added to Form
Possible Causes:
- Generation actually failed (check for error)
- PDF/Image had no readable content
- Prompt was unclear
- Technical issue
Solutions:
- Check for error messages
- Verify input (clear image, valid PDF, specific prompt)
- Try different input
- Contact support with details
Quality Issues
Questions Don't Make Sense
For AI Generation:
- Make prompt more specific
- Include context and details
- Specify difficulty level
- Try different model (GPT-5 for best quality)
- See AI Generation Tips
For Image/PDF:
- Ensure source material is clear
- Check if text was readable
- Try higher quality image
- Use smaller PDF sections
Questions Too Easy / Too Hard
Solutions:
- Specify difficulty in AI prompt
- Manually adjust difficulty after generation
- Use different source materials
- Generate multiple batches and select best
Wrong Answers Marked as Correct
Cause: AI error or unclear source material
Solution:
- Always review generated questions
- Verify correct answers manually
- Edit as needed in Google Forms
- Report persistent issues to support
License & Payment Issues
Purchase Didn't Activate License
Symptoms: Paid but still shows trial
Solutions:
- Check email for license key
- Open add-on → Activate License
- Enter license key from email
- Wait 1-2 minutes for activation
- Refresh if needed
- Contact support with order number if still not working
Can't Find License Key
Solutions:
- Check email (including spam folder)
- Search for emails from LemonSqueezy
- Check purchase confirmation
- Contact formquizgen@terrydjony.com with order details
License Key Not Working
Possible Causes:
- Typo in key
- Used on too many accounts
- Invalid key
Solutions:
- Copy-paste key carefully (no spaces)
- Ensure using correct Google account
- Contact support with license key for verification
Model & Settings Issues
Can't Access GPT-5
Cause: OpenAI account tier or availability
Solutions:
- Check OpenAI account status
- Request GPT-5 access at platform.openai.com
- Use GPT-4o instead (excellent quality)
- Contact OpenAI support for access
Settings Won't Save
Possible Causes:
- Browser issue
- Form permissions
- Cache problem
Solutions:
- Refresh form
- Clear browser cache
- Try different browser
- Re-install add-on if persists
Performance Issues
Add-on Loads Slowly
Solutions:
- Check internet connection speed
- Close other browser tabs
- Clear browser cache
- Restart browser
- Try incognito mode
Browser Crashes During Generation
Causes: Memory issues, browser problems
Solutions:
- Close unnecessary tabs
- Restart browser
- Update browser to latest version
- Try different browser (Chrome recommended)
- Check computer resources
Google Forms Issues
Questions Not Formatting Correctly
Cause: Form settings or transfer issue
Solutions:
- Manually adjust formatting
- Check question type settings
- Re-generate if severely broken
- Contact support with screenshots
Can't Edit Generated Questions
Cause: Form permissions or Google Forms issue
Solutions:
- Check if you're form owner
- Refresh form
- Try editing in new tab
- Copy questions to new form if needed
Getting More Help
Before Contacting Support
Gather this information:
- What were you trying to do?
- What happened instead?
- Any error messages? (screenshot)
- What troubleshooting steps did you try?
- Browser and operating system
Contact Information
Email: formquizgen@terrydjony.com
Include:
- Detailed description of issue
- Screenshots if applicable
- Steps to reproduce
- Your Google account email (if relevant)
Response Time: 1-2 business days
License & Billing Issues
For purchase issues:
- Email formquizgen@terrydjony.com
- Include order number
- Describe the issue
- We'll resolve within 24-48 hours
For OpenAI billing:
- Contact OpenAI support at help.openai.com
- We don't handle OpenAI billing
Known Limitations
Current Limitations
- PDF Size: Large PDFs (10+ pages) may timeout
- Image Quality: Low-quality images may not work well
- Complex Math: Very complex equations may not convert perfectly
- Languages: Best support for English
- Handwriting: Variable results with handwritten content
Workarounds
- Split large PDFs into smaller sections
- Use high-quality, clear images
- Manually adjust complex mathematical notations
- Use typed content when possible
- Edit generated questions as needed
Common Questions
Why does my trial count show incorrectly?
Trial count updates after successful generation. If generation failed, it shouldn't count.
Can I get a refund on the license?
Due to instant digital delivery, refunds are limited. Contact support to discuss specific issues.
Why do I need my own OpenAI API key?
This gives you full control over costs, privacy, and usage. We don't charge markup on generation costs.
How often should I update my API key?
Only when needed (compromised, lost, or expired). Keys don't expire automatically.
Can I use this offline?
No, the add-on requires internet connection to function.
Reporting Bugs
Found a bug? Help us fix it:
- Describe the bug: What happened?
- Steps to reproduce: How can we make it happen?
- Expected behavior: What should have happened?
- Screenshots: If applicable
- Environment: Browser, OS, Google account type
Send to: formquizgen@terrydjony.com
Feature Requests
Have an idea for improvement?
Email us at formquizgen@terrydjony.com with:
- Feature description
- Use case (why would this help?)
- How you'd use it
We love feedback and consider all suggestions!