Technical Documentation
Overview
The logo upload system on product pages has been enhanced with timeout protection and manual cancellation support, eliminating the issue where uploads could get stuck indefinitely.
What's New
1. Automatic Timeout (30 seconds)
Uploads now automatically timeout after 30 seconds if they don't complete. This prevents:
- Infinite loading states when network stalls
- Permanently disabled upload buttons
- Need to refresh the page when uploads hang
User Experience:
- Upload attempts that hang will auto-cancel after 30 seconds
- Clear error message: "Upload cancelled or timed out (30s)"
- Upload button becomes immediately available to retry
- All product customization data is preserved
2. Manual Cancellation
A new "Cancel Upload" button appears during uploads, allowing you to:
- Stop an upload at any time
- Retry immediately without waiting for timeout
- Preserve all product customization progress
- Avoid page refresh
How to Use:
- Start uploading a logo
- If you want to stop, click the red "Cancel Upload" button
- Select a different file and try again
3. Better Error Messages
Upload errors now provide clear, actionable feedback:
- "Upload cancelled or timed out (30s)" - Upload was stopped automatically or manually
- "Failed to upload logo" - Network or server error occurred
- "File size must be less than 5MB" - File is too large
- "Only JPG, PNG, PDF, SVG, EPS, and AI files are allowed" - Invalid file type
Technical Details
Supported File Formats
- Images: JPG, JPEG, PNG, SVG
- Vector Graphics: EPS, AI, PDF
- Maximum Size: 5MB per file
Network Requirements
- Stable internet connection recommended
- Minimum 1Mbps upload speed for 5MB files
- Automatic retry recommended on slow/unstable connections
Browser Compatibility
- Chrome 66+
- Firefox 57+
- Safari 12.1+
- Edge 79+
- All modern mobile browsers
Common Scenarios
Slow Connection
Problem: Upload takes longer than expected
Solution:
- Wait for 30-second timeout
- Check your internet connection
- Try uploading a smaller file (compress images)
- Retry during better network conditions
Upload Stuck
Problem: Upload spinner keeps spinning
Solution:
- Click "Cancel Upload" button
- Check network connection
- Verify file size is under 5MB
- Try uploading again
Wrong File Selected
Problem: Started uploading wrong file
Solution:
- Click "Cancel Upload" immediately
- Select the correct file
- Upload again
Troubleshooting
Upload Always Times Out
- Check internet speed (test at fast.com)
- Reduce file size (compress images before upload)
- Verify file is under 5MB
- Try different network (mobile data vs. WiFi)
Cancel Button Not Appearing
- Button only appears during upload
- Refresh page if upload state is stuck
- Clear browser cache
- Contact support if issue persists
Upload Completes But File Not Shown
- Verify upload shows "File Uploaded" status
- Check uploaded file name is displayed
- Refresh the page
- Re-upload the file
- Contact support with error details
Best Practices
For Optimal Upload Performance:
-
Compress Images
- Use JPG for photos (higher compression)
- Use PNG for logos with transparency
- Use SVG for vector graphics (smallest size)
-
Stable Connection
- Upload on WiFi instead of mobile data
- Avoid uploading during peak hours
- Close bandwidth-heavy applications
-
File Preparation
- Keep files under 2MB when possible
- Use web-optimized formats
- Remove unnecessary metadata
Related Features
Need Help?
If you experience persistent upload issues:
- Try the troubleshooting steps above
- Check your network connection
- Contact support with:
- File size and format
- Browser type and version
- Error message received
- Network speed test results
Last Updated: November 2, 2025