When customers try to upload images in the product customizer, the upload may fail silently, show an error, or produce a broken image on the canvas. This guide covers the common causes.

Symptoms

• The upload button does nothing or shows a loading spinner that never completes.
• An error message appears after selecting a file.
• The uploaded image appears as a broken placeholder on the canvas.
• Uploads work for administrators but not for logged-out customers.

Cause 1: File size exceeds the upload limit

Chamevo has its own file size limit, and the server has PHP limits that may be lower.

Fix:

1. Go to Chamevo → Settings → Features → Uploads.
2. Check Maximum Image Size (MB) — the default is 10 MB.
3. Increase if needed.
4. Also check your server's PHP limits:
   • upload_max_filesize — must be at least as large as the Chamevo setting.
   • post_max_size — must be larger than upload_max_filesize.
5. Increase PHP limits via php.ini, .htaccess, or your hosting control panel.

Cause 2: Login required setting is enabled

Chamevo can require users to be logged in to upload images.

Fix:

1. Go to Chamevo → Settings → Features → Uploads.
2. Check Login Required.
3. If enabled, only logged-in WordPress users can upload. Disable it if you want all customers to upload.

Cause 3: Server permission issues

The WordPress uploads directory may not have write permissions.

Fix:

1. Verify the wp-content/uploads/ directory has write permissions (typically 755 for directories, 644 for files).
2. Check if a security plugin restricts file uploads.
3. Test uploading through the standard WordPress Media Library — if that fails too, it is a server permissions issue.

Cause 4: Security plugin blocking the upload

Some security plugins block file uploads that contain base64-encoded image data or large POST payloads.