Using the web editor

Open the web editor, choose Code or Screenshot, then adjust the background and framing. Code can be pasted or imported from a UTF-8 text file (up to 64 KiB and 500 lines). Screenshots can be PNG, JPEG, or WebP files up to 20 MiB and 12 megapixels. Animated images use their first frame. HEIC is supported by the iPhone app, but not the web editor.

Download PNG, WebP, or JPEG at 1× (1024 px), 2× (2048 px), or 4× (4096 px) on the longest edge. Each draft remembers its export size and format. Copy PNG depends on your browser’s clipboard support and permissions; use Download if copying is unavailable. Your code and images are processed locally. A fresh visit needs a connection to load the editor and its rendering assets.

In Screenshot mode, choose Redact, then drag over the screenshot or choose Add area. Select an area to move it, drag a corner to resize it, or enter X, Y, Width, and Height as percentages of the original image. Each area has its own Solid color, Pixelate strength, or Blur strength. You can add up to 32 areas. Use Delete area to remove the selection. Delete also works while the area overlay or list is focused; Escape cancels a drag, or exits Redact when no drag is active. On touchscreens, drag the area or its corner handles. Large overlapping Blur/Pixelate areas may reach the processing limit; reduce the areas or use Solid.

Use Solid for passwords, keys and card numbers. Blurred or pixelated text may be recoverable. The original remains editable in the local draft. Downloads and clipboard images flatten the redactions before resizing and never include selection outlines. A successful replacement image clears its areas; a failed import or Retry renderer keeps the current areas.

The latest draft for each mode saves in this browser. Storage can be blocked, full, or cleared by the browser, so retain downloaded copies. Keep the tab open if saving fails. Clear local drafts removes both saved drafts and resets the editor; it does not delete downloaded images or your original files. If rendering stops, use Retry renderer. Very large inputs may need reducing on devices with limited memory.

The code image uses a bundled font for consistent exports. Some scripts and emoji are not supported; a warning identifies characters rendered with replacement glyphs. Screenshots are treated as sRGB, so wide-gamut colors may differ. If you report a browser-editor issue, include your browser, device, and the steps that led to it.

Getting started on iPhone

BGBG is coming soon for iPhone. The download link will appear on the homepage when it is available. The app requires iOS 18.6 or later. Start with adding a background, then explore layout and export sizes.

An image won’t import

Try a PNG, JPEG, or HEIC image from Photos or Files. If the original is stored in iCloud, open it in Photos or Files first and allow it to download. Check that you have a working connection for that download and enough free space on your iPhone.

If BGBG reports an import error, try the import again or choose another image. A file with an image extension can still be incomplete or damaged.

I can’t save to Photos

Saving requires permission to add images to your photo library. If permission was denied, use Open Settings in the error alert and allow BGBG to add photos. Then return and retry the export.

You can also choose Share PNG and use the system share sheet to save to Files. Importing with the Photos picker and saving to the photo library are separate operations, so a successful import does not mean saving is allowed.

My export looks different from what I expected

Open Ratio to check the canvas shape and export dimensions. The PNG has a 4096-pixel longest edge; it does not preserve the source’s original pixel dimensions. Small source images can look softer when enlarged.

Check that the foreground stays inside the canvas. Moving or scaling it beyond the canvas clips the overflow. Use Reset position & size in Layout to return to a centered fit.

A project shows unsaved edits

BGBG saves automatically, but a failed disk write can leave edits only in memory. Free up storage if needed, then use Retry when the app offers it. Keep the app open until saving succeeds; an unsaved draft cannot survive app termination.

Where are my projects?

Projects live on the device where you created them. BGBG does not provide cloud project sync or an account-based restore. Keep exported copies of images you want to retain. Uninstalling the app removes its local data.

The gallery menu lets you rename, duplicate, or delete a project. Deleting the project does not delete previously exported PNGs from Photos or Files.

Background blur or area pixelation?

The Blur slider inside Background softens the backdrop. The separate Blur tool lets you draw or add pixelated rectangles on the foreground image. Read the pixelation guide for step-by-step instructions.