Troubleshooting Guide
Solutions to common issues and problems you might encounter while using VesselVault.
Login & Account Issues
❌ Can't log in / "Wrong password" error
Try these solutions:
- Double-check your email address (common typos: .com vs .co.uk)
- Ensure Caps Lock is off
- Try typing password in a text editor first, then copy/paste
- Clear browser cache and cookies
- Try a different browser or incognito/private mode
- Use "Forgot Password" link to reset
❌ Account locked / Too many attempts
Solution:
- Wait 15-30 minutes before trying again
- Use "Forgot Password" to reset your password
- Contact support if lockout persists
- Check if you have multiple accounts with similar emails
❌ Not receiving password reset emails
Check these locations:
- Spam/Junk folder
- Promotions tab (Gmail)
- Email blocked/filtered lists
- Wait 10-15 minutes (emails can be delayed)
- Try requesting reset again with exact email address
❌ Logged out unexpectedly
Common causes:
- Session timeout (security feature)
- Browser closed or crashed
- Network interruption
- Multiple tabs/devices (session conflicts)
Prevention: Save work frequently, stay active, use single browser session.
Loading & Performance Issues
❌ Pages loading slowly or not at all
Immediate fixes:
- Check your internet connection (try other websites)
- Refresh the page (Ctrl/Cmd + R)
- Clear browser cache and cookies
- Close other browser tabs to free memory
- Try incognito/private browsing mode
- Switch to different browser (Chrome, Firefox, Safari)
❌ Photos won't upload or upload very slowly
Solutions:
- Check file size (large photos take longer)
- Ensure stable internet connection
- Try uploading one photo at a time
- Switch to WiFi from mobile data
- Resize photos on your device first
- Try different browser
❌ Dashboard or forms not responding
Quick fixes:
- Wait 30 seconds (may be processing)
- Refresh the page
- Check browser console for errors (F12)
- Disable browser extensions temporarily
- Try different device or browser
❌ Mobile site not working properly
Mobile troubleshooting:
- Update your browser app
- Clear browser cache on mobile
- Try different mobile browser
- Restart your phone/tablet
- Check available storage space
- Switch between WiFi and mobile data
Form & Data Issues
❌ Form won't submit / "Error saving" message
Common solutions:
- Check all required fields are filled (look for red text)
- Ensure numbers are in correct format (no letters in number fields)
- Check file upload size limits
- Remove special characters from text fields
- Try submitting without file uploads first
- Clear form and start fresh
❌ Data not saving or disappearing
Possible causes:
- Session expired during form completion
- Network interruption during save
- Browser back button used (loses form data)
- Multiple tabs/windows causing conflicts
Prevention: Save frequently, stay logged in, use single browser tab.
❌ Quick maintenance buttons not working
Troubleshooting steps:
- Ensure you have a vessel selected (check active tab)
- Wait for page to fully load
- Try clicking different category tabs first
- Refresh dashboard and try again
- Check browser console for JavaScript errors
❌ Can't edit boat information
Check permissions:
- Ensure you have 'owner' or 'engineer' role for this boat
- Verify you're logged into correct account
- Check if boat is owned by different user
- Contact boat owner for access if needed
Browser & Compatibility Issues
❌ Site looks broken or layout is wrong
Browser issues:
- Update your browser to latest version
- Clear browser cache and cookies
- Disable browser extensions/add-ons
- Check zoom level (100% recommended)
- Try different browser (Chrome, Firefox, Safari, Edge)
❌ Features not working in specific browser
Recommended browsers:
- Chrome: Excellent compatibility
- Firefox: Good performance
- Safari: Best for Mac/iOS
- Edge: Good for Windows
Avoid: Internet Explorer, very old browser versions
❌ JavaScript errors or features disabled
Check settings:
- Ensure JavaScript is enabled in browser
- Check if ad blockers are interfering
- Disable browser security extensions temporarily
- Allow cookies for VesselVault domain
- Check corporate firewall/proxy settings
❌ Mobile responsiveness issues
Mobile optimization:
- Use device in portrait orientation for best experience
- Ensure screen zoom is at 100%
- Update mobile browser app
- Clear mobile browser cache
- Try different mobile browser
General Troubleshooting Steps
When all else fails, try these systematic troubleshooting steps:
Step-by-Step Troubleshooting:
- Refresh the page (Ctrl/Cmd + R)
- Clear browser cache and cookies
- Try incognito/private browsing mode
- Disable extensions temporarily
- Try different browser (Chrome, Firefox, Safari)
- Check different device (phone, tablet, computer)
- Test different network (WiFi vs mobile data)
- Restart device if problems persist
Information to Gather Before Contacting Support:
- Browser & Version: Chrome 91, Safari 14, etc.
- Device & OS: iPhone iOS 14, Windows 10, etc.
- Error Messages: Exact text of any error messages
- Steps to Reproduce: What you were doing when issue occurred
- Screenshots: Visual evidence of the problem
- Time & Date: When the issue occurred
Still having trouble? Contact our support team with the information above. We're here to help and usually respond within 24 hours!
Quick Fixes
🔄 Refresh Page: Solves 60% of issues - try this first!
🧹 Clear Cache: Fixes loading and display problems
🕵️ Incognito Mode: Tests without extensions/cache
🔄 Different Browser: Often solves compatibility issues
Supported Browsers
✅ Fully Supported:
- Chrome (latest)
- Firefox (latest)
- Safari (latest)
- Edge (latest)
⚠️ Limited Support:
- Older browser versions
- Mobile browsers (older)
❌ Not Supported:
- Internet Explorer
- Very old mobile browsers
Contact Support
Still need help? We're here for you!