Troubleshooting

Most issues fall into one of the categories below. Work through the steps that match what you’re seeing — most things resolve in a few taps. If nothing here helps, see Still stuck? at the bottom for ways to reach us.

Using the desktop app? Jump to the Desktop app section for computer-specific fixes — finding the frame's network, connection retries, and setup-mode choices. The Frame not checking in and Reset sections apply to every setup.

Pairing & setup

The app can’t find my frame

1. Make sure the frame’s status light is slowly blinking blue — that’s setup mode.
2. If it’s pulsing or blinking purple, the frame has switched to broadcasting its own Wi-Fi hotspot. Keep the app open on the search screen — it can usually bring the frame back into pairing mode on its own. Or restart the frame: hold its power button for about 2 seconds to turn it off, then press once to turn it back on.
3. If it’s solid green or off, press the power button once to wake it, then try again.
4. Bluetooth on your phone is on, right?
5. If the app says Bluetooth access needed, tap Allow Bluetooth — or Open Settings if the permission was turned off earlier. The app can’t see the frame without it.
6. Move closer to the frame — Bluetooth has a limited range.
7. Last resort: factory reset and start over.

Left setup halfway earlier? Keep the app open on the search screen for a minute or two — it can usually bring the frame back into pairing mode on its own.

Setup didn’t finish

If the app closed or went to the background partway through setup — a call came in, you switched to another app to find your Wi-Fi password — the frame can be left in your account without ever getting your Wi-Fi details. It will show on your Frames tab but never come online, and the app will show a Setup didn’t finish notice at the top of Frames.

To finish:

1. Press the button on the back of the frame once (a short press — don’t hold it).
2. Tap Scan code on the notice, or open Add a frame, and scan the code on the back of the frame again.
3. Follow the Wi-Fi step through to the end and keep the app open until you see your first photo arriving.

Scanning the code again does not create a second frame; it picks up the same one and completes it.

”Your phone’s Bluetooth needs a nudge” (Android)

Occasionally Android’s Bluetooth service refuses to start a new scan, usually after Bluetooth has been switched off and on or after a lot of scanning. The app waits and retries on its own for a few seconds. If it still can’t scan, it shows this notice with an Open Bluetooth settings button: turn Bluetooth off and on again (or Airplane mode on, then off), come back to the app, and tap Look again. Nothing needs doing on the frame.

”That code doesn’t match” during setup

Typing the 4-character code from the frame’s screen by hand is easy to mis-read — check each character against the display and try again. Lowercase is fine, and the code never uses easily-confused characters like 0/O or 1/I.

• If the app says too many incorrect codes, the frame pauses code checks until it restarts: hold its power button for about 2 seconds to turn it off, press once to turn it back on, then re-enter the code.
• Scanning the QR code on the frame’s display skips typing entirely.

Wi-Fi won’t connect

• Double-check the password (case-sensitive).
• 5 GHz-only networks aren’t supported. Wallie needs 2.4 GHz.
• Move the frame close to your router for setup — you can hang it in its real spot afterwards. The first connection is the one that needs the strongest signal.
• Networks that ask you to log in through a webpage when you join (hotels, cafes) won’t work — use Direct Transfer instead.
• The app shows a signal-strength indicator before you commit to a network. If it’s flagged as weak, pick another network or use Direct Transfer.
• Still stuck? Your iPhone’s Personal Hotspot works as a temporary network: turn it on in Settings (with “Maximize Compatibility” if shown), set the frame up on it, and switch the frame to your home Wi-Fi later from its settings in the app.

Frame Recovery — when a frame won’t connect at all

If a frame never finished setup, won’t join any network, or seems stuck, the app has a built-in rescue tool that updates the frame’s software directly from your phone — no Wi-Fi needed on the frame.

1. Tap the ? in the corner of any setup screen (or on the sign-in screen), and choose Frame Recovery.
2. Follow the steps on screen — the app finds your frame, checks its software, and installs the latest version over the frame’s own hotspot.
3. When it finishes: press the button on the back of the frame once, wait for the QR code on its screen, then go to Add Frame and scan it.

A frame left on its QR screen naps to save battery — the QR stays on the display, and opening the app or a single button press wakes it. Your photos and settings are never touched by recovery. If the frame doesn’t appear in the list, make sure it’s plugged in and press the button on its back once; as a last resort, hold that button for 10 seconds until the lights go dark — that restarts setup, photos safe.

”Wrong password” but I’m sure it’s right

Type it in carefully one more time. If it fails again, the frame returns to setup — re-enter from scratch. Make sure caps lock is off and that special characters in the password are exactly right.

Keeping the app up to date

Photos are processed on your phone, not on the frame — so a lot of what you see on the wall depends on which version of the app sent it. We improve that processing regularly, and older builds keep using the older pipeline.

If something doesn’t look the way you expect, or a reprocess doesn’t change anything, check for an update first:

• iPhone / iPad — Wallie Frame on the App Store
• Android — Wallie Frame on Google Play

Photos already on your frame keep whatever processing they were given when you added them. To bring them up to the current version, see reprocessing.

Photos & display

The photo looks softer / less saturated than on my phone

That’s expected — Wallie reflects light like a real print rather than glowing like a phone screen. Some photos translate beautifully; others are a better fit for screens. See Image Tips for what looks best.

The frame keeps showing the same photo

• Wallie may be framing that photo. In the app, tap Resume Album to go back to the album rotation.
• Your schedule may be paused. Check the frame’s settings in the app.
• If you’re offline, the frame can only rotate through what it already has. Send more photos via Direct Transfer or reconnect Wi-Fi.
• If none of those apply and the frame is online, it may be downloading photos it can’t open. See the next section.

The frame is online but won’t show new photos

This one has three different looks, and they share a cause:

• The frame keeps showing the same photo, even though the album has others and nothing is framed.
• The display shows speckled static, like an untuned television, where a photo should be.
• A frame you’ve just set up stays on its setup screen, with the QR code, and never shows a first photo.

In the app, the frame looks healthy. It’s online and reporting its battery.

What’s going on. Every photo is locked on your phone before it leaves, with a key your phone keeps. During setup, your phone hands a copy of that key straight to the frame. The frame uses it to open each photo it downloads.

If your phone and your frame end up holding different keys, the frame still downloads every photo, but it can’t open any of them. A frame doesn’t show what it can’t open. So it holds the last photo it could open, or it stays on the setup screen if it has never opened one. Some software versions show the unopened data as static instead.

This usually follows a change of phone, or deleting and reinstalling the app. A phone that doesn’t have your original key makes a new one. Photos you add from then on are locked with the new key, while a frame you set up earlier still holds the old one.

The fix is three steps, in this order.

1. Check the key on your phone. Open Profile → Photo Key Backup and read the banner at the top.

• Your photos are protected, and your albums open in the app: your phone’s key is fine. Go to step 3.
• This phone made a new photo key, or your older albums are blank in the app: your phone has a new key. Try to get the original back first, with Older albums are blank or spin forever in the app. Your frames already hold the original key, so if that works, they start showing photos again without anything more. If you can’t get it back, go to step 2.
• Another phone has a different key: stop there and email us before changing anything.

2. Rebuild your photos with the key this phone has now. This step works on an iPhone or iPad. On the same screen, find Rebuild photos on this phone and tap Check what can be rebuilt. It tells you how many photos it can recover before you commit to anything. Then tap Rebuild my photos. Wallie re-uploads each photo from your own photo library, locked with this phone’s key. It needs iCloud Photos turned on and permission to read your photo library, and it only covers photos still in that library. It can take a long time, so leave the phone charging and on Wi-Fi.

On an Android phone, or if the check finds fewer photos than you expected, email us before going on to step 3.

3. Pair the frame again, so it receives the key this phone has now. In the app, go to Frames → tap the frame → All settings → Device Information → Remove and Factory Reset, then follow Getting Started. This erases the photos stored on the frame. Your photos in the cloud and your account are not affected. Once it’s paired, the frame downloads every photo this phone can open. If you rebuilt in step 2, that means the rebuilt photos and any you’ve added since. A photo that couldn’t be rebuilt won’t come back to the frame. Do one frame at a time, and wait for it to show a photo before starting the next.

Still not showing photos? Email us with your frame’s Device ID and which of the three looks you’re seeing. We can see that a frame is connecting and downloading, which tells us where to look. We can’t see your photos.

A photo I queued never appeared

Up Next follows your frame’s schedule: if the frame was asleep (outside wake hours) or a photo is framed, queued photos wait. Check the estimated times in the Up Next editor, and tap refresh on the frame’s screen to show the next queued photo immediately.

Older albums are blank or spin forever in the app

There’s no error message for this one — it shows up as a combination:

• Photos in your older albums appear as blank or grey tiles, or spin and never finish loading.
• Albums you’ve added recently are fine.
• Your frames are unaffected — they keep showing and rotating the photos they already have.
• A replacement frame made no difference.

That last pair is the tell. It means the app is running on a phone that doesn’t have the key your older photos were locked with — almost always after moving to a new phone. It’s tied to the phone, not the frame, so replacement hardware doesn’t fix it, and neither does a factory reset. There’s nothing wrong with the frame to reset: the photos on it are the ones still showing correctly.

You may also find the app won’t let you add photos or set up a frame while this is going on, and tells you why. That’s deliberate — it keeps the problem from spreading to your frames and to anyone you share with — and it lifts once your photos open again.

If your old phone still works, start there. Open Wallie on it, go to Profile → Photo Key Backup, and check the banner at the top says your photos are protected. If it doesn’t, follow the steps it gives you — on iPhone and iPad that’s usually iCloud Keychain switched off; on Android, a missing screen lock. Then open an older album on the new phone. The photos come back on their own once the key arrives, so give it a little time.

If that doesn’t do it, use the recovery code. On the old phone tap Show my code, then on the new phone tap Enter a code and type it in. This is also the route when the old phone is already gone — erased, traded in, or lost — provided you saved the code somewhere.

Only enter a code when photos are genuinely missing. If the app warns that this phone already has a code, replacing it can stop photos that currently open from opening.

No code and no old phone? The photos may still be rebuildable. If the originals are still in your own photo library, Wallie can rebuild your albums from them. On an iPhone or iPad, open Profile → Photo Key Backup, find Rebuild photos on this phone, and tap Check what can be rebuilt — it tells you how many it can recover before you commit to anything. Rebuild my photos then starts it.

A few things worth knowing before you do: it needs iCloud Photos turned on and permission to read your photo library, and it only covers photos still in that library. Rebuilding re-uploads each one, so it can take a long time — leave the phone charging and on Wi-Fi. Your frames keep showing what they already have while it runs.

None of that working? Email us with what you’re seeing before you change anything. Photos that aren’t in your photo library and have no saved code may not be recoverable, but we’d rather look first.

→ Switching phones on purpose? Saving your recovery code first is the whole fix: Switching to a new phone.

The e-ink display flashes when changing photos

That’s the display cycling through its colors during a refresh — a normal part of how e-ink works. Each refresh takes about 30 seconds.

Frame not checking in

Wallie always makes the first move: on its schedule, the frame wakes, reaches out to its server — Wallie’s cloud, or the Photo server on your computer — and asks “anything new?” The app never contacts a sleeping frame. So when the app says the frame hasn’t checked in, the question is: what stopped the frame from reaching its server?

If your photos live on your computer

The frame can only check in while all three are true:

• Your computer is on and awake. A sleeping computer stops answering — the most common cause of a frame that “froze” for hours.
• The Photo server is running. Look for Photo server · Running in the app’s sidebar.
• Frame and computer are on the same Wi-Fi network. If your photos live on a network drive, that drive must be reachable too.

Check in right now

Press the button on the back of the frame once. It wakes, checks in, and picks up any waiting photos and settings — no waiting for the next scheduled check-in.

Why the app’s numbers stop moving

Everything the app shows — battery, the current photo — arrives with each check-in. When check-ins stop, those numbers don’t go wrong, they go stale, and the app marks them with their age (for example, “Battery 28% — 12 days old”). A battery reading that hasn’t changed in days usually means the frame hasn’t been heard from — not that the battery is fine.

Battery & power

How long a charge lasts

Most frames go two to three months between charges. Some go longer — four months and beyond is common on a relaxed update schedule. Heavily used frames land closer to a month.

The difference is mostly how much the frame does, not the battery itself. A frame in the hallway on a six-hour schedule sips power. One in the kitchen that everyone opens in the app, with photos changing hourly, works considerably harder.

There’s no fixed number to expect, and a frame that lasts six weeks isn’t faulty — it’s being used more. If yours is going flat in under two weeks, email us and we’ll take a look.

Battery drained quickly

• Responsive Mode uses more battery — switch to Power Saver when you don’t need instant updates.
• A frequent schedule (e.g. every 30 minutes) drains faster than the default of every 3 hours.

• A frequent schedule (e.g. every 30 minutes) drains faster than the default of every 3 hours.

• On the original 13”: Responsive Mode uses more battery — switch to Power Saver when you don’t need instant updates.
• A frequent schedule (e.g. every 30 minutes) drains faster than the default of every 3 hours.

Frame won’t wake up

Try the app first: open the frame and tap Next Photo — it reaches the frame over Bluetooth even in deep sleep.

On the 10" and 13" v2, try the app first: open the frame and tap Next Photo — it reaches the frame over Bluetooth even in deep sleep.

1. Plug in via USB-C and let it charge for a few minutes — battery may be fully drained.
2. Press the power button once. You should see a light right away.
3. If still nothing, do a factory reset.

Red LED

Something failed during a refresh — usually a network error or a temporarily corrupted download. The frame will retry on its next scheduled wake. If you see red persistently, do a factory reset.

Direct Transfer

My phone can’t find the Wallie-XXXXXX network

• The frame has to be set up with Set Up Without Cloud for this network to exist. If it was set up with Wi-Fi, see “I want to switch between Wi-Fi and offline modes” below.
• Wake the frame first (a quick press of the power button), then start the transfer from the app.
• On iOS, the network sometimes requires manual selection in Settings → Wi-Fi.
• The network only stays open for a few minutes after each wake. If it’s gone, wake the frame again.

Transfer is stuck

• Cancel from the app and retry — the connection occasionally drops.
• Make sure your phone hasn’t auto-switched back to home Wi-Fi mid-transfer.

I want to switch between Wi-Fi and offline modes

Switching takes a reset, whichever way you’re going — there’s no in-app toggle. Factory reset the frame, then pair it again and pick the other mode this time: Set Up with Wi-Fi, or the Set Up Without Cloud link under it. A reset from the power button keeps the photos stored on the frame, and your account and albums are never affected.

Desktop app

These apply when you set up or manage a frame with the Wallie desktop app on a Mac, Windows, or Linux computer.

My computer can’t find the Wallie-XXXXXX network

• Press the button on the back of the frame once. That wakes it and starts its wireless network. The network goes back to sleep after a period of inactivity, so this is the first move whenever it’s missing.
• Stay near the frame — the network’s range is modest.
• Give it a few seconds after the button press, then retry from the app or refresh your computer’s Wi-Fi list.

Stuck on “Connecting to frame…”

• Press the frame’s button once and leave the dialog open — the app keeps retrying on its own.
• Connect manually instead: open your computer’s Wi-Fi settings and join the frame’s network. The network name and password are shown in the app with copy buttons.
• Some computers quietly switch back to a known network with internet access. If the connection drops mid-way, re-join the frame’s network and try again.

”That code doesn’t match” in the desktop app

Same rules as on the phone — see above. Check each character against the frame’s display; lowercase is fine. After too many incorrect codes, the frame pauses code checks until it restarts: hold its power button for about 2 seconds to turn it off, press once to turn it back on, then re-enter the code.

The app can’t scan — no Bluetooth, or Bluetooth is off

• If your computer has Bluetooth, turn it on in system settings and click Scan Again. The frame handles its own side automatically while it shows the setup screen.
• No Bluetooth at all? Use the wizard’s manual path: type the frame’s network name (it looks like Wallie-XXXXXX) and the 4-character code, both shown on the frame’s setup screen. See Manual setup.

I picked the wrong mode during setup

The choice between Copy photos onto the frame and Get new photos over your home Wi-Fi is permanent for that pairing. To switch: factory reset the frame, then set it up again and pick the other option.

A frame on “Get new photos over your home Wi-Fi” stopped updating

Almost always the computer, not the frame: it’s asleep, or Wallie isn’t open. See Frame not checking in.

Reset

Soft reset (try this first)

Turn the frame off — hold the button until you see solid red, then release while it’s still red. Wait 10 seconds, then press once to wake. Most minor issues clear up here.

Factory reset (last resort)

A factory reset from the power button wipes Wi-Fi, account pairing, and all settings — but the photos stored on the frame are kept, so even an accidental reset can’t lose them. A factory reset started from the app (Frames → tap the frame → All settings → Device Information → Remove and Factory Reset (labelled Factory Reset in older versions of the app)) additionally erases every photo stored on the frame — use that one before selling or giving a frame away. Your photos in the cloud and your Wallie account are never affected — re-pairing brings everything back.

One exception. If what’s missing is missing in the app — older albums blank, recent ones fine — a reset is the wrong tool here, and doing it now makes things worse. That’s a problem with your phone’s key rather than the frame: setting the frame up again pushes your phone’s current key to it, so the photos the frame is still showing correctly would stop working too. The app may refuse to set up a frame while it detects this. Start with Older albums are blank or spin forever in the app instead.

Desktop app: there's no in-app factory reset. Before selling or giving a frame away: if you chose Copy photos onto the frame, connect to the frame and use Remove all photos, then do the power-button reset above. If your photos live on this computer, the power-button reset alone is enough — nothing is stored on the frame.

Hold the power button and watch the light on the back. It tells you exactly what stage you’re in:

What you see	What it means
Nothing	A quick press just wakes Wallie. Release.
Solid red	Shutdown zone. Release here to power off.
Flashing white	Reset warning. Release here to cancel — nothing happens.
Light goes dark (a few seconds after the flashing starts)	Reset triggered. Release — Wallie is wiping itself and restarting.
Blinking blue (after reboot)	Wallie is back to factory settings and ready to pair again.

What you see	What it means
Nothing	A quick press just wakes Wallie. Release.
Solid red	Shutdown zone. Release here to power off.
All lights flashing	Reset warning. Release here to cancel — nothing happens.
All lights go dark (a few seconds after the flashing starts)	Reset triggered. Release — Wallie is wiping itself and restarting.
Blinking blue (after reboot)	Wallie is back to factory settings and ready to pair again.

What you see	What it means
Nothing	A quick press just wakes Wallie. Release.
Solid red	Shutdown zone. Release here to power off.
All lights flashing — flashing white on the 10” and 13” v2	Reset warning. Release here to cancel — nothing happens.
Light goes dark (a few seconds after the flashing starts)	Reset triggered. Release — Wallie is wiping itself and restarting.
Blinking blue (after reboot)	Wallie is back to factory settings and ready to pair again.

So to do a factory reset, keep holding through every stage above until the flashing suddenly goes dark. That darkness is your cue to release. The whole hold takes around ten seconds — but trust the light, not the clock.

If you change your mind partway through, release while the lights are still flashing and nothing will happen.

After a factory reset, follow Getting Started again. Your photos and account come back as soon as you re-pair.

Important: before re-pairing the frame, clear it from the app: Frames → tap the frame → All settings → Device Information → Remove and Factory Reset (labelled Factory Reset in older versions of the app). Otherwise the app won’t let you pair it fresh.

Resetting from the app works even while the frame sleeps — the app wakes it over Bluetooth and the reset starts within about 30 seconds.

If the frame is asleep, a reset started from the app runs at its next scheduled wake — or immediately if you press the button.

Resetting from the app works even while the frame sleeps: on the 10" and 13" v2 the app wakes the frame over Bluetooth and the reset starts within about 30 seconds. On the original 13", a sleeping frame resets at its next scheduled wake — or immediately if you press the button.

Still stuck?

Two ways to reach us:

• Live chat — tap the chat icon at the top of this page (or the bubble in the bottom-right in a regular browser).Live chat — open wallieframe.com in your web browser and use the chat bubble in the corner.
• Email — hello@wallieframe.com, any time. Include:
  • Your frame’s Device ID — see below
  • What the LED is doing
  • What you tried

We typically reply within a few hours to a business day.

Where to find your Device ID

Set up from the desktop app? Tell us the frame's network name instead — it looks like Wallie-XXXXXX and appears on the frame's setup screen and in the app when connecting. Or just describe what's happening and we'll work from there. The steps below are for the phone app.

1. Open the Wallie app and tap Frames in the bottom nav.
2. Tap the frame you’re having trouble with, then tap All settings.
3. Scroll to the bottom of the screen to the Device Information card.
4. The Device ID is the first row — long-press to copy it.

If the frame never finished pairing, you won’t have a Device ID yet. In that case, tell us the last 6 characters of the Bluetooth name the app showed during setup (it looks like Wallie-XXXXXX), or just describe what’s happening and we’ll work from there.