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.

”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.

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

The switch only goes one direction in the app:

• From Set Up Without Cloud → Wi-Fi: open the frame in the app and tap Upgrade to Cloud. You’ll sign in (or create an account) and pick your home network — no reset needed.
• From Wi-Fi → Without Cloud: there’s no in-app toggle. Factory reset the frame, then pair it again and choose Set Up Without Cloud this time. Your photos and account come back as soon as you re-pair.

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 → Factory Reset) 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 → Factory Reset. 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.