QuickStage · troubleshooting · credits · QuickFix · listing photography

When a QuickStage Photo Fails: Your Credit, the Email, Next Steps

If a QuickStage photo fails to stage, its credit comes back automatically and we email you. Here's what each symptom means and what to try next.

By QuickStage Team7 min read

If a photo fails to stage in QuickStage, the credit it used goes back to your balance automatically, whether it was one of your three free photos, a $1 pay-as-you-go credit or a plan credit. Your results page shows "Staging failed — credit refunded" where the photo would be, and we email you to say the same thing. The fix is usually the source photo: give us a brighter, level, full-size frame with the right room type, and run it again.

What counts as a failed photo?

"It didn't work" can mean three different things, and each has a different fix:

  • The photo failed to stage. No staged image came back. This is the main case in this guide, and the credit is returned.
  • The upload was rejected before staging started. Something about the file itself couldn't be processed, and you'll see an error on screen right after uploading instead of a result. Upload the original file again, or a different photo of the room.
  • The photo staged, but something in it is off. A plant blocking a window, a rug at an odd angle. That isn't a failure. It's what QuickFix is for (step 6 below).

What happens to your credit when a photo fails?

It comes back on its own. You don't need to email anyone, fill in a form or wait for a review.

  1. The photo is marked failed and one credit goes back to the email address the photo was staged under. Each failed photo is refunded once.
  2. A failed QuickFix returns the QuickFix, not a photo credit, and your original staged photo stays as it was.

On the results page, the failed photo shows "Staging failed — credit refunded" in place of the image. If other photos in the same upload staged fine, the summary line at the top adds a count, such as "1 failed (credits refunded)".

This automatic credit return is separate from our refund policy for plan charges. For that one, you email support@quickstage.io within 7 days of your most recent charge, and the request is reviewed and prorated by unused credits. You don't need it for a failed photo.

What does the email say?

When you stage on quickstage.io, results are emailed to the address you entered, as well as shown on screen. A failure is never silent:

  • If every photo in the upload failed, the subject line reads "We couldn't stage your photo — your credit has been refunded" (or the plural version for several photos).
  • If some photos staged and some didn't, you get the usual "ready" email with your before-and-after photos, plus a note at the top saying how many couldn't be staged and that those credits have been refunded automatically.

That note also carries our first suggestion: this occasionally happens with unusual angles or very dark photos, so try the photo again, and a different angle of the room often works. The rest of this guide expands on that advice.

The Failed-Photo Decision Table

Find the line that matches what you see, then jump to the step it points to.

What you see Likely cause What to do
"Staging failed — credit refunded" on one photo A very dark frame or an unusual angle Reshoot brighter or pick a different angle of the same room (steps 1, 2 and 5)
Every photo in an upload failed Something the photos have in common: all shot at dusk, all screenshots, all tilted Fix the shared problem before re-uploading the set (steps 1 to 3)
An error right after upload, before any result The file itself couldn't be processed Upload the original file again, or a different photo of the room (step 3)
The same room fails twice The frame, not the style Change the angle, not the style; if it fails again, contact us (steps 5 and 7)
The photo staged, but something in it is wrong Not a failure; the result needs a correction Use QuickFix with a plain-words note instead of spending a new credit (step 6)
No email arrived Spam or promotions folder, or a typo in the address Check spam, then open your photo library with the same email (step 7)
The refunded credit doesn't show You staged under a different email than the one you paid with Credits are tied to the email address; stage with the same one (step 7)

What to try next: seven steps in order

Work through these in order. Steps 1 to 4 are about the source photo, and steps 5 to 7 cover the retry itself. The photo is worth the effort: in NAR's 2025 Profile of Home Staging, 73% of buyers' agents rated listing photos highly important (that survey is about staging and photos in general, not virtually staged photos specifically).

  1. Shoot or pick a brighter frame. Turn on every light in the room, open the blinds and shoot in daylight. A room that reads as dark gray on your phone gives the system little to work with. If you only have a dusk shot, use a different photo of the room if one exists.

  2. Level the verticals. Hold the camera level at about chest height and check that door frames and wall corners run straight up and down. QuickStage is built to keep walls, windows, floors and paint colors as photographed, and it keeps your camera angle too, so a tilted frame stays tilted in the result.

  3. Upload the original file. Use the photo straight from the camera or your phone's photo library, not a screenshot, a copy saved out of a text message or a crop. Those copies are smaller and softer than the original, and resolution is something we can't add back later.

  4. Pick the right room type. Every photo gets a room type and a style. The room types include living room, bedroom, kitchen, bathroom, dining room, home office, laundry room, closet and garage, plus exteriors. A primary bedroom staged as a living room won't look right even when the staging itself works, so match the menu to what the room actually is.

  5. Try a different angle of the same room. If one frame fails, shoot or choose another: from a doorway looking in, or from a corner looking across the room. A straight-on shot of a single wall gives the least room to stage.

  6. If it staged but isn't right, use QuickFix instead of a new credit. Describe the problem in plain words ("move the plant so it isn't blocking the window") and the photo re-renders with that correction, without spending a credit. New visitors get one free QuickFix, and every plan includes a monthly allowance: Basic 7, Pro 20, Studio 50, Agency 100. If you don't see the QuickFix button on a photo, email support@quickstage.io and we'll take care of it.

  7. If it still fails, or something is missing, contact us. First check your spam folder, then open your QuickStage photo library with the email you staged under: we send a sign-in link, and every photo you've generated is there. Make sure you're using the same email you paid with, because that's where your credits live. If a photo still won't stage or a credit looks wrong, email support@quickstage.io with the address you used and which photo it was, or ask Quill, the support assistant on our site.

What does a retry cost you?

Nothing extra. The refunded credit pays for the second attempt, so a photo that fails once and stages on the retry costs one credit in total.

One credit is $1 on pay-as-you-go, with no subscription. Plans start at $19.99 a month, and the per-photo price drops to $0.13 on the monthly Agency plan and $0.11 on the annual Agency plan, billed yearly. A retry also takes about as long as the first try: results arrive in about 30 seconds a photo, on screen and by email.

That's why we'd rather you change the photo than repeat the same upload. The credit is safe either way, but the same dark or tilted frame is the most likely to fail the same way again. QuickStage's per-photo and plan prices are listed on one page if you're deciding between pay-as-you-go and a plan with a QuickFix allowance.

Bottom line

A failed QuickStage photo costs you nothing: the credit comes back automatically, the results page and the email both say so, and the refunded credit covers your next attempt. Before you retry, fix the frame (brighter, level, the original file, the right room type), or try another angle of the room. If it staged but needs a correction, use QuickFix instead of a new credit. If something still looks wrong, email support@quickstage.io.

Give QuickStage three of your rooms, free with no account or card.

Frequently asked questions

Do I get my credit back if a QuickStage photo fails?

Yes. When a photo fails to stage, its credit is returned to your balance automatically, whether it was a free trial photo, a pay-as-you-go credit or a plan credit. You don't need to ask for it.

Will QuickStage tell me if a photo failed?

Yes. The results page shows "Staging failed — credit refunded" where the photo would be, and the email you receive says the photo couldn't be staged and that its credit was refunded automatically.

What happens if a QuickFix re-do fails?

The QuickFix goes back to your allowance instead of a photo credit, and your original staged photo stays as it was, so you can try the correction again.

Why would a photo fail to stage?

Our failure email names the usual suspects: unusual angles and very dark photos. A brighter, level frame uploaded as the original file, or a different angle of the same room, usually gives the best chance on the retry.

Who do I contact if a QuickStage photo keeps failing?

Email support@quickstage.io with the email address you staged under and which photo failed, or ask Quill, the support assistant on quickstage.io.

Sources

All guides