Several translucent photo frames floating into a glowing circular upload portal

Image Upload

Grok Imagine Image Upload: Formats, Limits, Multiple References, and Fixes

Most image-upload problems are not mysterious: the file misses a format or size rule, the reference tray is already full, or the account is missing a permission. This guide covers the supported formats, the real limits, how multiple images work, and the fastest fixes for a failed upload.

Updated 2026-10-19Jump to FAQ

The 30-second answer

This studio accepts JPG, JPEG, PNG, WEBP, HEIC, and HEIF images. Each file can be up to 30 MB, with image dimensions from 256 to 5,760 pixels on a side. A single generation can use up to 9 reference images, alongside up to 3 reference videos and 3 audio files, for 12 materials total.

If an upload fails, check format, size, and dimensions first. Then check whether the reference tray is already full. Account-level restrictions come last, but they do happen: a workspace can disable uploads for every member.

The fastest first test: Export one clean JPG under 30 MB at roughly 1,024 to 2,048 pixels wide, then upload that single file. If it works, the issue is the original file, not the studio.

Single image, multiple references, and frames

The same upload button serves different jobs. Decide what the image is doing before you add it, because a reference set and a first frame are not interchangeable.

Input roleWhat it controlsUse it when

Single starting frameThe composition and first moment of the clipYou have one photo or still to animate

First and last frameA transition between two fixed momentsYou need a reveal, match cut, or before-and-after

Reference setThe look, subject, product, or style across a generationYou need consistency rather than an exact opening frame

Multiple referencesSeveral ingredients in one renderThe subject, location, and styling come from different images

The upload limits that matter

These are the numbers to keep beside you. They apply to a single generation request, not to your whole account.

ItemLimitPractical note

Image formatsJPG, JPEG, PNG, WEBP, HEIC, HEIFHEIC works, but export to JPG if another step fails

File size30 MB per imageResize oversized phone photos before uploading

Pixel dimensions256 to 5,760 pxVery small or giant images can both be rejected

Reference imagesUp to 9 per generationUse distinct angles and details, not nine copies

Reference videosUp to 3, 2 to 15 seconds eachTrim to the exact action you want to carry over

Reference audioUp to 3, 15 seconds totalA clean voice or music clip, not a full track

Combined requestUp to 64 MBLarge images add up quickly across nine slots

A grid of floating reference frames with cool light rims in a dark room — Fewer, cleaner references usually beat a large pile of near-duplicates.

Upload a reference image without losing control

The goal is not just to get the file into the tray. It is to make the model understand which part of the image matters.

Prepare the fileCrop to the subject, remove distracting borders, and export a clean 1,024 to 2,048-pixel JPG or PNG. Keep the original if you may need a larger frame later.
Choose the roleUse the image as a first frame when composition is fixed, as a last frame when the ending is fixed, or as a reference when only the look needs to carry.
Describe the job in wordsName the role of each reference in the prompt: the first image is the product, the second is the location, the third is the lighting reference. Do not make the model guess.
Generate a short draftTest at the shortest useful duration and 768P. If the reference is fighting the prompt, the cheap draft makes that obvious.

Common upload errors and what to change

Work down this table in order. The first two rows explain most failed uploads.

Message or symptomLikely causeWhat to try

Upload failedFile format, size, or dimensionsExport a 1,024-pixel JPG under 30 MB and retry

Image upload not workingBrowser or connection interruptedHard refresh, try a private window, or switch browser

Uploads are disabled for your teamWorkspace or account permissionAsk the workspace owner or contact support

File appears but the result ignores itReference role not describedState what the image controls in the prompt

Upload stalls near completionCombined request near the 64 MB capRemove extra references and retry with one file

Image looks soft after generationSource resolution or motion settingsUse a sharper source and gentler camera movement

A dark glass upload tray with a single glowing frame hovering above it — A simple, single-frame test isolates the file from the rest of the request.

How to use multiple images well

Multiple references are not a vote. Each image should answer a different question. A useful set might contain a face for identity, a garment for wardrobe, a room for location, and a colour frame for the grade.

Start with two or three images. Add more only when you can name the exact job each one performs. Nine weak references give the model more ways to compromise; three strong ones give it a clear target.

Use the same subject from different angles when identity matters.
Avoid two references that show contradictory lighting unless the contradiction is intentional.
Keep product references clean and centred; background clutter becomes part of the scene.
If a reference is only a colour cue, say so in the prompt instead of letting it dominate the composition.

Frequently asked questions

What image formats can I upload?+

JPG, JPEG, PNG, WEBP, HEIC, and HEIF. Each image can be up to 30 MB with dimensions from 256 to 5,760 pixels.

How many images can I upload at once?+

Up to 9 reference images per generation. The same request can also include up to 3 reference videos and 3 audio files, with 12 materials in total.

Why does my image upload fail?+

Start with file size, pixel dimensions, and format. If those pass, remove extra references to get under the 64 MB request limit, then try a fresh browser session.

What does “image uploads are disabled for your team” mean?+

It usually means a workspace-level permission, not a bad file. Ask the account owner to enable uploads for your team, or contact support with the exact message.

Can I combine two images into one generation?+

Yes. Upload both as references and describe the role of each one in natural language. A clean subject image plus a separate location or style reference is usually easier to control than a collage.

Can I delete an uploaded image?+

Remove it from the reference tray before submitting. After a generation, manage the asset through the history or account controls available on your surface; the studio does not promise a separate permanent-delete action.

Related guides

Turn the Reference Into Motion

Upload a clean frame, describe the movement, and draft at 768P before committing to a final render.

See Plans