Table of Contents
Troubleshooting Guide
Having trouble with Portal LMS? This guide will help you solve common issues and get back to learning quickly.
🚨 Quick Troubleshooting
[Image: Common error messages]
Most Common Issues
- •Can't Login → Check credentials, reset password, contact administrator
- •Page Not Loading → Check internet connection, refresh browser, clear cache
- •Can't See Content → Check permissions, verify enrollment, contact administrator
- •Notifications Not Working → Check notification settings, email configuration
- •Mobile Issues → Use supported browser, check mobile settings
🔐 Login & Authentication Issues
Can't Login
Problem: "Invalid credentials" or "Login failed"
Solutions:
- •
Check Credentials
- •Verify email address is correct
- •Ensure password is entered correctly
- •Check for typos in email or password
- •
Reset Password
- •Click "Forgot Password" on login page
- •Check email for password reset link
- •Follow instructions to create new password
- •
Contact Administrator
- •Ask administrator to verify your account status
- •Request new login credentials if needed
- •Check if account is active and properly configured
Problem: "Account not found" or "User doesn't exist"
Solutions:
- •
Verify School URL
- •Ensure you're using the correct school URL
- •Check with administrator for correct portal address
- •Try accessing from different device/browser
- •
Check Account Status
- •Contact administrator to verify account creation
- •Ensure account is active and not suspended
- •Check if account was created with correct email
Problem: "Access denied" or "Permission denied"
Solutions:
- •
Check Role Assignment
- •Contact administrator to verify role assignment
- •Ensure you have appropriate permissions
- •Check if role is active and properly configured
- •
Verify School Access
- •Ensure you're enrolled in the correct school
- •Check if school account is active
- •Verify school-specific access permissions
🌐 Browser & Technical Issues
Page Not Loading
Problem: Page won't load or shows error
Solutions:
- •
Check Internet Connection
- •Verify internet connection is working
- •Try accessing other websites
- •Check if school network has restrictions
- •
Browser Issues
- •Try refreshing the page (F5 or Ctrl+R)
- •Clear browser cache and cookies
- •Try a different browser (Chrome, Firefox, Safari, Edge)
- •Disable browser extensions temporarily
- •
System Requirements
- •Ensure browser is up to date
- •Check if JavaScript is enabled
- •Verify browser supports modern web standards
Problem: Slow loading or performance issues
Solutions:
- •
Browser Optimization
- •Close unnecessary browser tabs
- •Clear browser cache and cookies
- •Disable unnecessary browser extensions
- •Restart browser
- •
System Resources
- •Check available memory and CPU usage
- •Close unnecessary applications
- •Restart computer if needed
- •Check internet connection speed
📱 Mobile Issues
Mobile App Problems
Problem: Mobile site not working properly
Solutions:
- •
Browser Compatibility
- •Use supported mobile browser (Chrome, Safari, Firefox)
- •Ensure browser is up to date
- •Try accessing from different mobile browser
- •
Mobile Settings
- •Check if JavaScript is enabled
- •Verify mobile data or WiFi connection
- •Clear mobile browser cache
- •Restart mobile browser
Problem: Touch navigation issues
Solutions:
- •
Touch Settings
- •Check touch sensitivity settings
- •Ensure touch gestures are enabled
- •Try different touch gestures
- •Restart mobile device
- •
Display Issues
- •Check screen orientation
- •Adjust zoom level if needed
- •Verify display settings
- •Try different device orientation
📧 Notification Issues
Email Notifications Not Working
Problem: Not receiving email notifications
Solutions:
- •
Check Email Settings
- •Verify email address in profile settings
- •Check notification preferences
- •Ensure email notifications are enabled
- •Check spam/junk folder
- •
Email Configuration
- •Verify email server settings
- •Check if email account is active
- •Ensure email provider isn't blocking messages
- •Try different email address
Problem: Too many or too few notifications
Solutions:
- •
Notification Preferences
- •Go to Settings → Notifications
- •Adjust notification frequency
- •Select specific notification types
- •Set quiet hours if needed
- •
Notification Management
- •Unsubscribe from unnecessary notifications
- •Set up notification filters
- •Configure notification delivery methods
- •Manage notification timing
📚 Course & Assignment Issues
Course Access Problems
Problem: Can't see courses or course content
Solutions:
- •
Enrollment Status
- •Check if you're enrolled in the course
- •Contact administrator for enrollment verification
- •Ensure course is active and published
- •Check course start/end dates
- •
Permission Issues
- •Verify you have access to course content
- •Check if course requires special permissions
- •Contact instructor or administrator
- •Ensure role has appropriate access
Problem: Assignment not visible or accessible
Solutions:
- •
Assignment Status
- •Check if assignment is published
- •Verify assignment due date hasn't passed
- •Ensure assignment is visible to your role
- •Check if assignment requires prerequisites
- •
Assignment Access
- •Contact instructor about assignment access
- •Check if assignment is in draft mode
- •Verify assignment visibility settings
- •Ensure proper course enrollment
📊 Grade & Progress Issues
Grade Display Problems
Problem: Grades not showing or updating
Solutions:
- •
Grading Status
- •Check if assignment has been graded
- •Verify grading is complete
- •Contact instructor about grading status
- •Check if grades are published
- •
Display Issues
- •Refresh page to see updated grades
- •Check different grade views
- •Verify grade calculation settings
- •Contact administrator if grades are missing
Problem: Incorrect or missing grades
Solutions:
- •
Grade Verification
- •Contact instructor about grade accuracy
- •Check if grade was entered correctly
- •Verify assignment submission was received
- •Request grade review if needed
- •
Grade Calculation
- •Check grade calculation settings
- •Verify assignment weights and categories
- •Contact administrator about grade policies
- •Ensure proper grade configuration
💬 Communication Issues
Message & Communication Problems
Problem: Can't send or receive messages
Solutions:
- •
Communication Settings
- •Check communication preferences
- •Verify message permissions
- •Ensure communication features are enabled
- •Check if recipient is active
- •
Message Delivery
- •Check if message was sent successfully
- •Verify recipient email address
- •Check spam/junk folders
- •Try alternative communication methods
Problem: Announcements not visible
Solutions:
- •
Announcement Settings
- •Check announcement visibility settings
- •Verify you're in the target audience
- •Check if announcement is published
- •Ensure announcement is active
- •
Display Issues
- •Refresh page to see new announcements
- •Check different announcement views
- •Verify announcement permissions
- •Contact administrator about announcement access
🔧 Account & Profile Issues
Profile Management Problems
Problem: Can't update profile information
Solutions:
- •
Permission Issues
- •Check if you have permission to edit profile
- •Verify profile fields are editable
- •Contact administrator about profile permissions
- •Ensure account is active
- •
Profile Settings
- •Check if profile is locked or restricted
- •Verify required fields are completed
- •Check if profile is in read-only mode
- •Contact administrator for profile access
Problem: Profile information not saving
Solutions:
- •
Save Issues
- •Check if all required fields are completed
- •Verify internet connection is stable
- •Try saving changes in smaller batches
- •Contact administrator if issue persists
- •
Data Validation
- •Check if data format is correct
- •Verify field length limits
- •Ensure special characters are allowed
- •Check if data meets validation requirements
🚨 Emergency Issues
Critical Problems
Problem: Complete system access loss
Solutions:
- •
Immediate Steps
- •Try accessing from different device/browser
- •Check if other users are experiencing issues
- •Contact administrator immediately
- •Check school network status
- •
Recovery Steps
- •Wait for system recovery if it's a system-wide issue
- •Contact technical support for assistance
- •Check system status page if available
- •Follow emergency procedures if provided
Problem: Data loss or corruption
Solutions:
- •
Data Recovery
- •Contact administrator immediately
- •Do not attempt to fix data issues yourself
- •Report specific data that's missing or corrupted
- •Follow data recovery procedures
- •
Prevention
- •Regularly backup important data
- •Use system-provided backup features
- •Follow data management best practices
- •Report data issues promptly
📞 Getting Additional Help
When to Contact Support
Contact Administrator For:
- •Account creation and management
- •Role assignment and permissions
- •School-specific configuration
- •User management issues
Contact Technical Support For:
- •System-wide technical issues
- •Browser compatibility problems
- •Mobile app issues
- •Performance problems
Contact Instructor For:
- •Course content and assignments
- •Grading and feedback
- •Course-specific issues
- •Academic questions
Support Resources
- •FAQ: Check frequently asked questions
- •User Guides: Review role-specific documentation
- •Video Tutorials: Watch step-by-step guides
- •Community Support: Connect with other users
📋 Prevention Tips
Avoid Common Issues
- •
Keep Credentials Secure
- •Use strong, unique passwords
- •Don't share login credentials
- •Log out when finished
- •Use secure networks
- •
Regular Maintenance
- •Keep browser updated
- •Clear cache regularly
- •Check notification settings
- •Update profile information
- •
Best Practices
- •Use supported browsers
- •Check internet connection
- •Save work frequently
- •Report issues promptly
This guide is part of Portal LMS Phase 7 - Documentation & User Experience improvements. Last Updated: 2025-09-15