StagingLens Help Center

How can we help?

Everything you need to set up StagingLens, stage your listings and fix common issues. StagingLens uses your own OpenAI API key to stage your photos.

Jump to a topic

Getting started

Set up StagingLens once and you're ready to stage. Most people are done in about ten minutes.

1Install StagingLens
2Create an OpenAI API key
3Set up API billing
4Add your key in Settings

Install StagingLens

  1. Open your purchase receipt email and download StagingLens for Mac or Windows.
  2. Mac: open the downloaded file and drag StagingLens into your Applications folder. Windows: run the installer and follow the prompts.
  3. Open StagingLens. If you're asked for a license key, copy it from your receipt email.

See a security warning when opening the app? Check Security warning on install.

Create your OpenAI API key

Your API key connects StagingLens to your own OpenAI account. You only need to do this once.

  1. Go to platform.openai.com/api-keys and sign in to your OpenAI account, or create one.
  2. Open API keys. If you don't land there automatically, choose API keys in the sidebar.
  3. Click "Create new secret key." Name it something you'll recognize, like "StagingLens."
  4. Copy the key right away. OpenAI may only show the full key once.

Helpful tip: your key usually begins with sk-. Keep it private and don't share it with anyone.

Set up OpenAI API billing

This is the step most people miss. ChatGPT Plus and OpenAI API billing are separate. A ChatGPT Plus or Pro subscription doesn't include API usage, so StagingLens can't generate images until your API account has its own payment method or credits.

  1. At platform.openai.com, open Billing in your settings.
  2. Add a payment method or buy prepaid credits.
  3. Set a monthly spending limit so there are no surprises. A staged photo costs under 10¢.
  4. Make sure your project's spending limit isn't set to $0.

OpenAI may require account or organization verification before image generation is available. If OpenAI prompts you to verify your organization or identity, complete that process in your OpenAI Platform account before using StagingLens.

Add your key to StagingLens

  1. Open StagingLens.
  2. Click Settings in the top-right corner.
  3. Paste your OpenAI API key into the API Key field.
  4. Click Test Connection. This checks that your key and your OpenAI account are working.
  5. Click Save. If the test succeeds, you're ready to stage.

Your key is stored securely on your computer and is only sent to OpenAI.

Staging photos

The built-in staging rules handle most rooms on their own. Adjust any photo only when it needs something specific.

Projects and importing photos

  1. Create a project for each listing, and give it a clear name like the property address.
  2. Click Import Photos and choose the listing photos you want to stage.
  3. Each photo appears as a card showing its file name, room type, style and version.

Tip: use Projects in the top-left corner to switch between listings.

Staging controls

Click a photo to open its Staging Controls on the right:

Room
Bedroom, living room, kitchen, bathroom, patio, loft and more, so the furniture fits the space.
Look
A style, like Modern Neutral, Coastal or Contemporary Luxury, plus a color palette.
Staging
The staging mode, such as Stage Empty Room.
Additional instructions
Optional notes for this photo only, like "family room on the right, dining on the left" or "keep the existing couch."

Generate, try again and revise

  • Generate stages the selected photo using its controls.
  • Try Again creates a fresh version with the same settings. It's the quickest fix when a result is close but not right.
  • Open Review / Revise lets you compare versions and ask for a specific change to one result.
  • Every attempt is saved as a version, like "Version 2 of 2," so you can always go back to an earlier one.

Each generation, retry or revision is a separate OpenAI image, under 10¢ each.

Change many photos at once

  1. Check the box on each photo you want to change, or click Select All.
  2. Choose a Room, Style, Color or Action from the bar at the top.
  3. Click Apply, then Generate Selected, or Generate All to stage the whole project.

Approve and export

  • Click Approve on each result you're happy with, or Approve All.
  • Export Approved saves only approved images. Export Selected saves the photos you've checked. Export All Generated saves every staged result.
  • Staged photos export at 2048 pixels wide, sized for MLS and listing sites.

Tips for best results

  • Start with a good photo. Straight verticals, even exposure and a sharp image give the best staging.
  • Set the right room type. It has the biggest effect on what gets placed in the room.
  • Use a short instruction for tricky rooms. Say where things go, like "sofa facing the fireplace, keep the doorway on the left clear."
  • Keep the style consistent across photos of the same space so the listing looks cohesive.
  • Always review before delivering. Check doors, windows, fixtures and flooring against the original photo.

MLS disclosure

Choose how each staged photo is disclosed to match your MLS rules:

Listing disclosure only Default
No text on the image. You note virtual staging in your MLS listing.
"Virtually Staged" label
Adds a "Virtually Staged" label to the image.
Custom disclosure text
Adds your own wording, for MLS or brokerage rules that require specific language.

Some states and MLSs require a label on the image itself. California, for example, requires a clear label plus a way for buyers to see the original photo, so use the "Virtually Staged" label option there. Check your local rules and keep the unstaged originals on file.

Costs and your plan

OpenAI costs

OpenAI bills image generation directly to your own OpenAI account, at under 10¢ per staged photo at OpenAI's current rates. A 15-photo listing comes in under $1.50. Retries and revisions cost about the same as a first pass. Set a monthly spending limit in your OpenAI billing settings to stay in control.

Your StagingLens subscription

  • New subscriptions start with a 14-day free trial. You're charged when the trial ends unless you cancel first.
  • To cancel, update your card or switch between monthly and annual, use the customer portal link in your receipt email.
  • Cancelling stops future charges. You keep access until the end of the period you've paid for.
  • See the refund policy for refund details.

Troubleshooting

If something isn't working, start here.

I see "cannot currently generate images"

This almost always comes from your OpenAI API account, not StagingLens. Check these in order:

  • Your API account has a payment method or credits. ChatGPT Plus doesn't count.
  • Your credits aren't used up.
  • Your project or organization spending limit hasn't been reached, and isn't $0.
  • OpenAI hasn't prompted you to verify your organization or identity. If it has, complete that in your OpenAI Platform account.

Fix it in your OpenAI account, then click Test Connection again in Settings.

My API key is invalid

Go to platform.openai.com/api-keys, create a new secret key, and paste it into StagingLens again.

  • Paste the whole key, with no spaces before or after it.
  • A deleted or revoked key won't work. Create a new one.

I copied the key, but nothing happens

Open Settings, paste the key, click Test Connection, then click Save. The key isn't used until it's saved.

Staging is slow, or I see "too many requests"

New OpenAI accounts have lower rate limits, which rise as your account builds usage history.

  • Wait a minute or two, then try again.
  • Stage large listings in smaller groups with Generate Selected.

A result changed a wall, window or doorway

  • Click Try Again for a fresh version. This fixes most cases.
  • Check that the room type is right.
  • Add an instruction, like "keep the doorway on the left clear," or use Open Review / Revise to fix one detail.

I see a security warning when installing

Only download StagingLens from your receipt email or staginglens.com. If your computer still blocks the app, send us a message through the contact form and we'll help you open it safely.

My license key isn't accepted

  • Copy the key from your receipt email exactly, with no extra spaces.
  • Check that your subscription or trial is still active in the customer portal.
  • If you've set up a new computer, you may need to deactivate an old one. Use the contact form and we'll help.

I'm still stuck

Click the Help button in StagingLens and copy the error details, then paste them into the contact form so we can help faster.

Never send your full API key in an email.

Quick reminders

  • Your key usually starts with sk-.
  • Keep your key private.
  • You may only see the full key once, when it's created.
  • ChatGPT Plus and OpenAI API billing are separate.

Common questions

Do I need ChatGPT Plus?

No. StagingLens uses the OpenAI API, which is billed separately from ChatGPT Plus. You need an OpenAI account with API billing set up.

Is my API key safe?

Your key is stored locally on your computer and is only sent to OpenAI. StagingLens never sends it to our servers. Never share it publicly.

Where do my photos go?

From your computer straight to OpenAI for staging, then back to your computer. StagingLens doesn't upload or store your photos on its own servers.

Do I need to write prompts?

No. The staging rules are built in. Just choose the room, style and staging mode. Additional instructions are optional, for one-off requests.

Can I use StagingLens on two computers?

Yes. Paste your OpenAI key on each computer, or create a separate key for each one so you can revoke them individually.

What if my API key is ever exposed?

Delete it at platform.openai.com/api-keys, create a new one, and paste it into StagingLens Settings.

What size are the staged files?

2048 pixels wide, a common size for MLS uploads and listing sites.

Need more help?

Click the Help button in StagingLens, or send us a message through the contact form. We'll reply as soon as possible, usually within 24 hours.