Troubleshooting Guide
Find solutions to common issues and get your MaxChurches system running smoothly.
Quick Issue Search
Can't find your issue? Search our troubleshooting database.
Common issues:
Login problems
Member import errors
SMS not sending
Report generation
File upload issues
Login & Authentication Issues
Problems with logging in, password resets, and user access.
Possible Causes & Solutions:
Incorrect Password
- Check for typos in your password
- Ensure Caps Lock is not enabled
- Try typing password in a text editor first
- Use "Forgot Password" to reset
Account Issues
- Verify your account is active
- Check if account is locked
- Contact administrator for access
- Verify email address is correct
Troubleshooting Steps:
- Check Email: Look in spam/junk folder for reset email
- Verify Email: Ensure the email address is correct in your profile
- Wait Time: Allow 5-10 minutes for email delivery
- Try Again: Request a new password reset
- Contact Admin: If still not working, contact your system administrator
What to Do:
Account Security Measures
Your account may be locked due to:
- Multiple failed login attempts
- Suspicious activity detected
- Administrator action
- System security policy
Solution: Contact your system administrator immediately to unlock your account.
Member Management Issues
Problems with adding, editing, importing, and managing church members.
Common Import Issues:
File Format Issues
- Ensure file is in Excel (.xlsx) format
- Check column headers match exactly
- Remove empty rows and columns
- Verify data types (text, numbers, dates)
Data Validation Errors
- Check for duplicate email addresses
- Verify phone number formats
- Ensure required fields are filled
- Check date formats (YYYY-MM-DD)
Solution Steps:
- Download the import template from the system
- Fill in member data following the template exactly
- Save as Excel format (.xlsx)
- Try importing again with corrected data
Troubleshooting Steps:
Permission Issues:
- Verify you have "Add Member" permission
- Check if your role allows member creation
- Contact administrator for permission updates
System Issues:
- Check if system is in maintenance mode
- Verify database connection is working
- Clear browser cache and try again
Search Issues & Solutions:
Search Tips:
- Try searching with partial names (first name only)
- Check spelling of member names
- Use different search criteria (phone, email)
- Clear search filters and try again
Financial Management Issues
Problems with giving records, financial reports, and payment processing.
Common Issues:
Data Validation
- Check amount is entered correctly
- Verify member selection is valid
- Ensure giving type is selected
- Check date is not in the future
System Issues
- Check internet connection
- Verify database is accessible
- Try refreshing the page
- Clear browser cache
Report Generation Issues:
Common Solutions:
- Check date range selection is valid
- Ensure there is data in the selected period
- Verify you have permission to view reports
- Try generating report for a smaller date range
- Check if system is processing large amounts of data
Payment Issues:
Gateway Issues
- Check payment gateway configuration
- Verify API keys are correct
- Ensure gateway is not in test mode
- Contact payment provider support
User Issues
- Verify card details are correct
- Check card has sufficient funds
- Ensure card is not expired
- Try a different payment method
Events & Services Issues
Problems with event creation, attendance tracking, and service management.
Event Creation Issues:
Common Solutions:
- Check if you have "Create Event" permission
- Verify all required fields are filled
- Ensure event date is not in the past
- Check if event title is unique
- Verify location field is not empty
Attendance Issues:
Member Issues
- Verify member exists in system
- Check member status is active
- Ensure member is not already marked present
System Issues
- Check if event is properly configured
- Verify attendance tracking is enabled
- Ensure you have attendance permissions
Communication Issues
Problems with SMS messaging, email notifications, and WhatsApp integration.
SMS Issues & Solutions:
Configuration Issues
- Check SMS gateway configuration
- Verify API credentials are correct
- Ensure sufficient SMS credits
- Check sender ID is approved
Message Issues
- Check message length (160 characters max)
- Verify phone numbers are valid
- Ensure message content is appropriate
- Check for special characters
Email Issues:
Troubleshooting Steps:
- Check email configuration in system settings
- Verify SMTP server settings are correct
- Test email delivery with a simple message
- Check recipient email addresses are valid
- Look in spam/junk folders for delivered emails
System Performance Issues
Slow loading, timeouts, and general system performance problems.
Performance Solutions:
Browser Issues
- Clear browser cache and cookies
- Disable browser extensions temporarily
- Try using a different browser
- Check internet connection speed
System Issues
- Check if system is under heavy load
- Verify database performance
- Contact administrator for server issues
- Try accessing during off-peak hours
Timeout Solutions:
Immediate Actions:
- Refresh the page and try again
- Check your internet connection
- Try accessing from a different device
- Contact system administrator immediately
- Check if other users are experiencing the same issue
File Upload Issues
Problems with uploading documents, images, and other files.
Upload Issues:
File Issues
- Check file size (max 10MB)
- Verify file format is supported
- Ensure file is not corrupted
- Try renaming the file
System Issues
- Check internet connection stability
- Verify storage permissions
- Try uploading one file at a time
- Clear browser cache
Still Need Help?
If you can't find a solution to your problem, our support team is here to help.