Error Messages & Solutions 🚨

Decode error messages and fix issues quickly. Every error has a solution - let's find yours.

Common Error Messages

The most frequent errors and their solutions.

Authentication & Account Errors

"Invalid email or password"

What it means: Login credentials don't match our records.

Solutions:

1. Double-check email spelling - typos are common
2. Verify password - try typing in a text editor first
3. Check Caps Lock - passwords are case-sensitive
4. Use password reset - click "Forgot Password" link
5. Try different browser - clear cache and cookies

Still stuck? Contact support with your registered email address.

"Account not verified"

What it means: You haven't clicked the verification link in your email.

Solutions:

1. Check email inbox - look for verification message
2. Check spam folder - verification emails sometimes land there
3. Request new verification - use the resend option
4. Add to whitelist - add CrittrHavens to your email whitelist
5. Try different email - if your provider blocks automated emails

Pro tip: Verification links expire after 24 hours - request a fresh one if needed.

"Session expired - please sign in again"

What it means: You've been inactive too long or browser session ended.

Solutions:

1. Sign in again - simply log back into your account
2. Enable "Remember me" - stay logged in longer
3. Keep tab active - avoid long periods of inactivity
4. Check browser settings - ensure cookies are enabled

Prevention: Save work frequently and don't rely on auto-save for long sessions.

"Too many login attempts"

What it means: Account temporarily locked for security after multiple failed logins.

Solutions:

1. Wait 15 minutes - lockout is temporary
2. Use password reset - get a fresh password
3. Check for typos - common cause of repeated failures
4. Try different device - rule out device-specific issues

Security note: This protects your account from unauthorized access attempts.

Data & Sync Errors

"Failed to save - please try again"

What it means: Your data couldn't be saved due to connection or validation issues.

Solutions:

1. Check internet connection - ensure stable connection
2. Verify required fields - all required fields must be completed
3. Remove special characters - avoid unusual symbols in text
4. Refresh and retry - refresh page and re-enter data
5. Use copy/paste - preserve long entries while troubleshooting

Data protection: Don't navigate away until you see "Saved successfully" confirmation.

"Sync failed - data may be outdated"

What it means: Your device couldn't connect to sync latest data.

Solutions:

1. Check internet connection - sync requires stable connection
2. Refresh the page - force a new sync attempt
3. Log out and back in - reset your session
4. Clear browser cache - remove outdated cached data
5. Try different device - check if issue is device-specific

Important: Don't make major changes until sync is working to avoid conflicts.

"Duplicate entry detected"

What it means: You're trying to create something that already exists.

Solutions:

1. Check existing entries - look for similar pets, tasks, or items
2. Use different name - modify the name slightly
3. Update existing entry - edit the existing item instead
4. Check all habitats - item might exist in different location

Common causes: Similar pet names, identical task descriptions, duplicate inventory items.

Photo & Upload Errors

"Upload failed - file too large"

What it means: Photo exceeds the maximum file size limit.

Solutions:

1. Compress the image - use photo editing app to reduce size
2. Change photo quality - take new photo at lower resolution
3. Use different format - JPEG is usually smaller than PNG
4. Split into multiple uploads - upload photos one at a time

Size limits: Keep photos under 10MB for best results.

"Unsupported file format"

What it means: The file type isn't supported for upload.

Solutions:

1. Use supported formats - JPEG, PNG, WebP work best
2. Convert the file - use photo editor to change format
3. Check file extension - ensure it matches actual format
4. Take new photo - use device camera for compatible format

Supported formats: JPEG (.jpg), PNG (.png), WebP (.webp)

"Photo processing failed"

What it means: Photo couldn't be processed after upload.

Solutions:

1. Try uploading again - temporary processing issue
2. Use different photo - original might be corrupted
3. Reduce file size - large photos may time out during processing
4. Check internet connection - processing requires stable connection
5. Try different browser - some browsers handle uploads better

Processing time: Large photos may take 30-60 seconds to process.

Browser & Connection Errors

"Network error - please check your connection"

What it means: App can't connect to the internet or our servers.

Solutions:

1. Test internet connection - try loading other websites
2. Switch networks - try WiFi instead of cellular or vice versa
3. Restart router/modem - reset your internet connection
4. Try different browser - rule out browser-specific issues
5. Check firewall settings - ensure CrittrHavens isn't blocked

Temporary issues: Sometimes servers are briefly unavailable - try again in a few minutes.

"Page not found (404)"

What it means: The page you're trying to access doesn't exist.

Solutions:

1. Check the URL - ensure it's spelled correctly
2. Navigate from main menu - use app navigation instead of direct links
3. Clear browser cache - remove outdated page data
4. Try going back - return to previous page and try again
5. Restart from home page - navigate to main page first

Common causes: Outdated bookmarks, mistyped URLs, moved pages.

"Service temporarily unavailable (503)"

What it means: Our servers are temporarily down for maintenance or experiencing issues.

Solutions:

1. Wait and try again - usually resolves quickly
2. Check status page - look for maintenance announcements
3. Try basic features only - some features may still work
4. Use offline mode - view cached data while waiting

Maintenance: We announce planned maintenance in advance when possible.

Permission & Access Errors

"Access denied - insufficient permissions"

What it means: You don't have permission to access that feature or data.

Solutions:

1. Sign in to correct account - ensure you're using the right account
2. Check subscription status - feature might require Premium
3. Refresh your session - log out and back in
4. Contact support - if you should have access

Permission levels: Some features are limited to Premium subscribers.

"Feature not available"

What it means: The feature isn't accessible with your current account or browser.

Solutions:

1. Check account type - feature might be Premium-only
2. Update your browser - newer features require modern browsers
3. Enable JavaScript - required for most interactive features
4. Check device compatibility - some features are desktop/mobile specific

Browser requirements: Use Chrome 90+, Safari 14+, Firefox 90+, or modern Edge.

Payment & Billing Errors

"Payment declined"

What it means: Your payment method couldn't process the charge.

Solutions:

1. Check card details - verify number, expiration, CVV
2. Ensure sufficient funds - check account balance or credit limit
3. Contact your bank - they might have flagged the transaction
4. Try different payment method - use alternative card
5. Update billing address - ensure it matches your bank records

Common causes: Expired cards, international restrictions, bank security measures.

"Billing information required"

What it means: Payment method needs updating or verification.

Solutions:

1. Access customer portal - update payment details
2. Add valid payment method - enter new card information
3. Verify billing address - ensure accuracy
4. Contact support - if you continue having issues

Security: We use Stripe for secure payment processing.

System Requirements

Ensure your setup meets minimum requirements.

Browser Requirements

Minimum browser versions:

• Chrome 90 or newer
• Safari 14 or newer
• Firefox 90 or newer
• Edge (Chromium-based)

Required features:

• JavaScript enabled
• Cookies enabled
• Local storage support
• Service workers (for offline functionality)

Device Requirements

Minimum specifications:

• 2GB RAM for smooth operation
• 10% free storage space
• Stable internet connection (1 Mbps minimum)
• Modern device (manufactured 2018 or later recommended)

Optimal experience:

• 4GB+ RAM
• High-speed internet (5+ Mbps)
• Updated operating system
• Desktop or tablet for complex tasks

Network Requirements

Firewall settings:

• Allow connections to CrittrHavens domains
• Enable secure HTTPS connections
• Allow WebSocket connections for real-time features

Corporate networks:

• May require IT administrator to whitelist domains
• Proxy servers can interfere with uploads
• VPN may be needed if restrictions are severe

Error Reporting

Help us fix issues by reporting errors effectively.

What Information to Include

Essential details:

• Exact error message (screenshot preferred)
• What you were trying to do when error occurred
• Browser and version (found in browser settings)
• Device type and operating system
• Steps to reproduce the error

Additional helpful info:

• Time and date when error occurred
• Whether error happens consistently or randomly
• If error affects specific pets/data or everything
• Any recent changes to your setup

How to Report Errors

Through the app:

1. Navigate to Settings → Help & Support
2. Select "Bug Report" or "Technical Issue"
3. Include all relevant details
4. Attach screenshots if possible

Direct email:

• Include "ERROR REPORT" in subject line
• Provide detailed description
• Attach screenshots or screen recordings
• Include account email for verification

Temporary Workarounds

While waiting for fixes:

• Try different browser or device
• Use basic features only
• Save work more frequently
• Export important data as backup

Emergency alternatives:

• Use mobile app if web version has issues
• Access through different internet connection
• Use incognito/private mode
• Contact support for priority assistance

Getting Immediate Help

When you need help right away.

Emergency Support

Critical issues qualifying for emergency support:

• Complete inability to access account
• Data loss or corruption
• Security breaches
• Payment/billing emergencies

How to get emergency help:

1. Mark support request as "URGENT"
2. Include "EMERGENCY" in email subject
3. Clearly explain why it's time-sensitive
4. Provide backup contact information

Self-Service Options

Immediate fixes you can try:

• Clear browser cache and restart
• Try different browser or device
• Check internet connection
• Log out and back in
• Restart your device

Quick references:

• FAQ for common questions
• Troubleshooting for technical issues
• Getting Help for support options

Response Time Expectations

Standard support:

• Non-urgent issues: 24-48 hours
• Account issues: 12-24 hours
• Premium users: Priority handling

Emergency support:

• Critical issues: 4 hours during business hours
• Security issues: Immediate escalation
• Data loss: Within 6 hours

---

Remember: Every error message is telling you something specific. Read it carefully, try the suggested solutions, and don't hesitate to contact support if you're still stuck. We're here to help!