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:

  1. Start uploading a logo
  2. If you want to stop, click the red "Cancel Upload" button
  3. 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:

  1. Click "Cancel Upload" button
  2. Check network connection
  3. Verify file size is under 5MB
  4. Try uploading again

Wrong File Selected

Problem: Started uploading wrong file

Solution:

  1. Click "Cancel Upload" immediately
  2. Select the correct file
  3. 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:

  1. Compress Images

    • Use JPG for photos (higher compression)
    • Use PNG for logos with transparency
    • Use SVG for vector graphics (smallest size)
  2. Stable Connection

    • Upload on WiFi instead of mobile data
    • Avoid uploading during peak hours
    • Close bandwidth-heavy applications
  3. File Preparation

    • Keep files under 2MB when possible
    • Use web-optimized formats
    • Remove unnecessary metadata

Need Help?

If you experience persistent upload issues:

  1. Try the troubleshooting steps above
  2. Check your network connection
  3. Contact support with:
    • File size and format
    • Browser type and version
    • Error message received
    • Network speed test results

Last Updated: November 2, 2025