How to Fix Upload Issues in ImagiTool

Uploads can fail for a few specific reasons. This guide uses the exact upload errors shown in Photo Editor so you can fix the issue quickly.

What You'll Learn

• Which file formats and limits are enforced before upload.
• What each upload error means and the fastest fix.
• How to recover when loading fails after a file is accepted.

Step-by-Step Guide

Step 1: Confirm Format and Size First

• Supported upload formats are JPEG, PNG, WebP, AVIF, and HEIC/HEIF.
• Maximum file size is 30 MB in the Photo Editor upload flow.
• If your file is outside these rules, it will fail before upload starts.

Step 2: Match the Error Message to the Fix

• Unsupported file type Use one of the supported formats, then upload again.
• File too large. Max 30 MB Resize or compress the image, then retry.
• Invalid file Re-export the image from its source app and upload the new file.

Step 3: Handle HEIC/HEIF Conversion Errors

• If you see Failed to process HEIC/HEIF image. Please try a different format.: convert the file to JPG or PNG and upload again.
• HEIC/HEIF is processed client-side before normal upload continues.

Step 4: Recover from Post-Upload Load Failures

• If upload starts but ends with Failed to load image and Please try again: retry the same file once.
• If it repeats, refresh the page and upload again.
• If it still fails, export the image to a fresh JPG/PNG and re-upload.

Common Upload Errors You May See

• Unsupported file type -> File format is not allowed in Photo Editor upload validation.
• File too large. Max 30 MB -> File size is above the configured upload limit.
• Invalid file -> File metadata or binary payload failed validation.
• Failed to process HEIC/HEIF image. Please try a different format. -> HEIC conversion failed before upload.
• Failed to load image + Please try again -> File was accepted, but image rendering failed during load.
• Failed to load stock image. Please try again. -> Stock image fetch/conversion failed before entering the upload flow.

Pro Tips

• Keep source files under 30 MB before opening Photo Editor.
• For maximum compatibility, upload JPG or PNG when possible.
• If HEIC fails once, do not retry repeatedly; convert first, then upload.
• Rename files with standard extensions (.jpg, .png, .webp, .avif, .heic, .heif).
• If a file keeps failing, re-export it from the source app to remove malformed metadata.

Common Issues

Why does upload reject immediately?

Immediate rejection usually means format or size validation failed.

Why does upload progress move, then still fail?

The file passed upload checks but failed during image load/render.

Can I upload HEIC files directly?

Yes. HEIC/HEIF is supported, but conversion can fail on some files.

Why does one HEIC file work and another fail?

HEIC variants differ by encoder and metadata. Converting to JPG or PNG is the most reliable fallback.