Admin Guide
Complete guide to managing BetterLearn as an administrator. Configure settings, manage users, control pricing, and monitor platform analytics.
The admin panel is only accessible to users with admin, super_admin,
or moderator roles. Set roles via Clerk dashboard or database.
🔐 Accessing the Admin Panel
Navigate to /admin or click the Admin Panel link in your user menu (visible only to admins).
Setting Up Admin Access
Go to Clerk Dashboard
Open your Clerk dashboard at dashboard.clerk.com
Find the User
Navigate to Users and find the account to make admin
Edit Public Metadata
Add {"role": "admin"} or {"role": "super_admin"} to public metadata
Refresh & Access
The user can now access /admin after logging out and back in
📊 Admin Dashboard
The admin dashboard provides a comprehensive overview of platform metrics.
Key Metrics
Dashboard Features
- User Growth – New users in last 24h, 7 days, 30 days
- Quiz Statistics – Total quizzes and attempts
- Collection Overview – Public, private, and shared collections
- Storage Metrics – Files uploaded and storage consumption
- Recent Activities – Live feed of platform activity
👥 User Management
Navigate to Admin → Users to manage platform users.
User List Features
- Search – Find users by name or email
- Filter – Filter by role (all, admin, user)
- Sort – Sort by date, name, or credits
- Pagination – Navigate through user pages
User Actions
| Action | Description |
|---|---|
| View Details | See complete user profile, activity, and statistics |
| Adjust Credits | Add or remove credits from a user's balance |
| Change Role | Promote to admin or demote to regular user |
| View Quizzes | See all quizzes created by the user |
| View Collections | See user's collections and shared items |
User Roles
| Role | Permissions |
|---|---|
user |
Standard platform access, AI tools, quiz creation |
moderator |
View admin panel, limited management capabilities |
admin |
Full admin access except super-admin features |
super_admin |
Complete platform control, all settings |
⚙️ Site Settings
Navigate to Admin → Settings to configure platform-wide settings.
Branding
- Site Name – Platform name displayed throughout
- Site Logo – Upload custom logo (SVG, PNG, JPG)
- Favicon – Browser tab icon
- Footer Logo – Logo for footer area
Feature Toggles
- Enable Registration – Allow new user signups
- Enable AI Tools – Toggle AI features
- Enable Study Rooms – Toggle collaborative features
- Maintenance Mode – Show maintenance page to users
SEO & Meta
- Meta Title – Default page title
- Meta Description – Search engine description
- Social Image – Open Graph image for sharing
💰 Pricing Management
Navigate to Admin → Pricing to manage credit packages.
Pricing plans automatically sync with Stripe. When you create a plan, a corresponding Stripe product and price are created.
Creating a Pricing Plan
Click "Add Plan"
Open the new plan form
Set Plan Details
Enter name, credits amount, and price (in cents)
Configure Options
Set badge (Popular, Best Value), active status
Save
Plan syncs to Stripe and appears on subscription page
Plan Fields
| Field | Description |
|---|---|
| Name | Display name (e.g., "Starter Pack") |
| Credits | Number of credits included |
| Price | Cost in cents (e.g., 999 = $9.99) |
| Badge | Optional highlight (Popular, Best Value) |
| Active | Whether plan is available for purchase |
| Sort Order | Display order on pricing page |
🛠️ Tools Management
Navigate to Admin → Tools to configure AI tools.
Tool Configuration
- Enable/Disable – Toggle individual tools on or off
- Credit Cost – Set credits consumed per use
- Category – Assign tool to a category
- Description – Edit tool description
- Icon – Change tool icon
Tool Categories
Tools are organized into categories for easier navigation:
- Instructional Materials
- Communication
- Student Support
- Content Creation
- AI Assistant
- Assessment & Feedback
- Professional Development
- Classroom Management
📄 Content Pages
Navigate to Admin → Pages to manage static content pages.
Editable Pages
- Terms of Service – Platform terms and conditions
- Privacy Policy – Data handling and privacy
- FAQ – Frequently asked questions
- About – Platform information
- Contact – Contact information and form
Editing Pages
Use the rich text editor or Markdown to update page content. Changes are saved immediately and reflected on the live site.
❓ FAQ Management
Navigate to Admin → FAQs to manage frequently asked questions.
Managing FAQs
- Add FAQ – Create new question and answer
- Edit – Update existing FAQs
- Reorder – Drag to change display order
- Delete – Remove outdated FAQs
- Categories – Group FAQs by topic
📈 Analytics
Navigate to Admin → Analytics for detailed platform insights.
Available Metrics
- User Growth – Signups over time
- Quiz Creation – Quizzes generated per day/week/month
- Tool Usage – Most popular AI tools
- Credit Usage – Credits consumed over time
- Revenue – Purchases and revenue tracking
- Active Users – Daily/weekly/monthly active users
📁 File Management
Navigate to Admin → Files to manage uploaded files.
File Operations
- View – Browse all uploaded files
- Search – Find files by name or user
- Delete – Remove files to free storage
- Storage Stats – Monitor storage usage
Monitor storage usage regularly. Files are stored in AWS S3 and may incur costs based on your AWS plan.
📝 Quizzes & Collections
Navigate to Admin → Quizzes or Admin → Collections.
Quiz Management
- View All – See all quizzes across the platform
- Search – Find quizzes by title or creator
- Delete – Remove inappropriate or test content
- Statistics – View attempt counts and scores
Collection Management
- View All – See all collections
- Public/Private – Monitor visibility settings
- Shared – Track shared collections
📬 Contact Submissions
Navigate to Admin → Contact to view form submissions.
- View Messages – All contact form submissions
- Mark Read – Track which messages you've reviewed
- Reply – Respond directly via email
- Archive – Move resolved messages to archive
✅ Admin Best Practices
Security
Limit admin access to trusted team members. Use super_admin sparingly.
Monitoring
Check analytics weekly. Monitor for unusual patterns or abuse.
Backups
Regularly backup MongoDB. Enable point-in-time recovery in Atlas.
Pricing
Review pricing regularly. Adjust based on costs and competition.
🔧 Troubleshooting
Common Admin Issues
| Issue | Solution |
|---|---|
| Can't access admin panel | Verify role is set in Clerk metadata. Clear cache and re-login. |
| Pricing not syncing to Stripe | Check STRIPE_SECRET_KEY is correct. Verify webhook is configured. |
| Settings not saving | Check browser console for errors. Verify MongoDB connection. |
| Users can't see tools | Ensure tools are enabled in Tools management section. |
For technical issues, check the Environment Setup guide. For platform usage, see the User Guide.