Background blur in Figma fails when layer setup, clipping, or file performance blocks the effect—use the checks below to restore it fast.
When background blur stops rendering in a mockup, the cause is almost always a simple setup detail or a heavy file that’s choking the canvas. This guide shows clean, repeatable fixes that bring the frosted look back without guesswork. You’ll see where background blur reads from, which properties matter, and which file habits keep the effect steady across design, Dev Mode, and prototype view.
Background Blur Not Working Figma: Quick Checks
Quick check: Background blur only blurs pixels behind the selected layer inside the same frame. If the layer sits above empty space, or the content you expect to blur lives in another frame, the result will look like a flat overlay. Move both the overlay and the content you want to blur into one frame and keep the overlay on top.
- Confirm the effect type — In the right sidebar under Effects, add Background blur (not Layer blur). Layer blur softens the object itself; background blur softens what’s behind it.
- Add a semi-transparent fill — Give the blurring layer a fill (white or dark works) at 5–40% opacity. A fill helps you see the blur and yields the classic frosted panel look.
- Keep content in one frame — Background blur reads only the pixels behind it inside the same frame. Nest the overlay and the backdrop together.
- Check layer order — Place the blur layer above the content you want to soften. If a sibling layer covers it, the blur will seem to vanish.
- Toggle Clip content — If a parent frame clips content, the blur will only sample what’s inside the clipped area. Disable clipping on the parent if you need a wider sample area.
- Look for masks — Masks can limit what the blur can “see.” If a mask hides the backdrop, the blur returns nothing. Temporarily detach the mask to test.
- Trim heavy elements — Huge images and complex vectors can stall rendering. Downscale or flatten where possible, then recheck the blur.
Those seven checks fix nearly every “background blur not working figma” complaint in day-to-day files.
Why Background Blur Fails In Figma (And What To Do)
Deeper fix: If quick checks didn’t do it, match your scene to the way Figma’s rendering model works. Background blur is an effect that samples pixels already rendered behind your layer. No pixels there, no blur. Clip chains, masks, and nested frames change what counts as “behind.”
Inside One Frame, In The Right Order
Background blur samples only the stack beneath the layer in the same frame. Move the backdrop artwork and the blurring panel into one frame. Keep the blur layer above the artwork. If the overlay lives in a separate frame on a higher page level, it won’t read the background.
Clipping And Masks Change The Sample
Clip content on a parent frame blocks the blur from reading anything outside that frame’s bounds. If you need a panel to blur a large image behind it, either place the image inside the same frame or turn off clipping on the parent. Masks can also hide the sample area. If a mask cuts away the region behind your panel, the blur looks empty. Test by disabling the mask for a moment, then rebuild the mask with the overlay in mind.
Fills And Blend Modes
Background blur can look invisible on a clear shape. A subtle fill at low opacity reveals the softened backdrop while keeping text readable. Keep blend mode on Normal for predictable results. Certain blend modes create contrast that reads like a missing blur, even when the effect is active.
Layer Vs Background Blur
Layer blur modifies the selected object. Background blur modifies what’s beneath. If you picked Layer blur on the overlay, the card softens but the photo behind stays crisp. Switch the effect to Background blur for a glass card, leave it on Layer blur for soft avatars and image treatments.
Layer Order, Clipping, And Masks
Quick check: If two blurs overlap, a newer element can appear to “cancel” the blur under it. Keep a single overlay panel for the frosted region, or merge overlapping panels to avoid odd stacking results.
- Fix overlapping blurs — Combine panels or set one clear overlay on top. Two background-blur layers can fight for the same sample region.
- Rebuild messy groups — Ungroup, reorder, and regroup with a clean top-down stack: backdrop artwork → content → overlay (with background blur).
- Test with Clip content off — If turning Clip content off suddenly shows the blur, keep the overlay and backdrop in a non-clipped container or expand the clipping frame.
- Check mask order — Place masks under the overlay if they only shape the backdrop. Put the overlay outside the mask if you want the blur to sample the full scene.
If you run into a case where the blur shows in the editor but misbehaves in a prototype, reduce overlapping effects and try a single, simple overlay in that flow. Animation on shapes with background blur can stall in certain views; swapping to a static overlay per state is a safe fallback.
Performance Limits And Prototype Behavior
Quick check: Big files slow down blur. Large images, many pages, and complex vectors raise memory use and can block smooth rendering, especially in long prototypes.
- Cut memory hogs — Downscale giant images, flatten heavy vector groups, and delete hidden layers you no longer need.
- Split files by role — Keep the design system in a separate library file and link it. Lighter working files render effects more reliably.
- Trim prototype scope — Fewer frames per flow load faster. Duplicate a lean version of the flow you’re testing and re-run the blur there.
- Reduce simultaneous effects — Avoid stacking drop shadows, multiple blurs, and blend modes on the same overlay. One clean background blur is usually enough.
- Test on the target device — Preview on the same class of device your handoff targets. If a phone preview struggles, reduce overlay size and effect radius.
When memory warnings pop up, handle those first. Rendering a background blur means sampling pixels already in memory, so a strained file can drop frames or show odd color flashes during transitions. A lean file keeps blur steady through Smart Animate moves and page swaps.
Reliable Setup For Frosted Cards And Overlays
Quick setup: Use one overlay panel per frosted region and keep it simple. The steps below create a glass card that works in editor, Dev Mode, and prototype view.
- Create the panel — Draw a rectangle with the target size. Round the corners if needed.
- Add a soft fill — Set a white fill to 10–20% opacity. This reveals the blur and keeps text readable.
- Apply Background blur — In Effects, add Background blur. Start at 12–24 and tweak to taste based on the backdrop texture.
- Place above content — Move the panel above the background artwork and any scrolling content that should soften behind it.
- Keep in one frame — Nest both the panel and backdrop inside a single frame; leave Clip content off unless you’re intentionally cropping the scene.
- Test with text — Add a short line of text on the panel to confirm legibility. Increase fill opacity or blur strength if the backdrop stays too sharp.
This build avoids hidden dependencies. It reads clean in handoff and mirrors common OS treatments, which keeps Dev Mode mapping straightforward.
Troubleshooting Table: Causes And Fixes
Quick scan: Use this table to match the symptom to the fastest repair.
| Symptom | Likely Cause | Fast Fix |
|---|---|---|
| Panel looks flat | Layer blur applied, or no fill on panel | Switch to Background blur; add 10–20% white fill |
| Nothing blurs | Overlay and backdrop in different frames | Move both into one frame; keep overlay on top |
| Blur stops at frame edge | Parent frame clips content | Turn off Clip content or enlarge the clipping frame |
| Blur vanishes under a button | Overlapping panels or order conflict | Merge panels; keep one overlay above all UI |
| Prototype stutters | High memory use | Downscale images; flatten vectors; split files |
| Odd color banding during motion | Animated shape uses background blur | Swap to static overlays per screen state |
| Dev Mode shows mismatch | Effect visible in editor, unclear in spec | Confirm effect type; note the blur value in comments |
Pro Tips To Keep Blur Stable
- Prefer a single overlay — One panel with background blur beats stacks of tiny blurred chips.
- Keep the radius sensible — Values in the 12–32 range usually read well; huge radii cost render time with little gain.
- Use frames to contain edges — If you need clean rounded edges, place the overlay inside a frame with the same radius and Clip content on.
- Avoid heavy blend stacks — Start with Normal blend and opacity; add contrast layers only if you truly need them.
- Trim image weight — Replace massive photos with export-scaled versions. Keep backdrop textures under control.
- Isolate the flow — For a demo, duplicate just the screens you need. A lean demo file keeps blur responsive.
- Leave a note for devs — In handoff, specify “Background blur: 16; Fill: #FFF @ 16%.” That avoids a Layer blur mix-up on the build side.
If you still hit a stubborn scene, rebuild one panel from scratch with a soft fill, apply background blur, and move it over the backdrop inside a single frame. This fresh panel becomes a clean source you can reuse. That small reset clears most layout quirks tied to old groups, masks, or effect stacks that drifted over time.
Use these steps whenever background blur stops behaving. The pattern is simple: one frame, correct effect, clean order, minimal clipping, and a reasonable file. Follow that, and the frosted card look stays reliable across pages and prototypes—even on older hardware.
