Opening images

How to get a photo into the image editor: uploading, drag and drop, pasting, sample images, how HEIC, TIFF and camera RAW files are converted in your browser, how very large images are resized, and what happens when you replace, crop or clear an image.

Everything described here happens on your own device. The file is read and converted by your browser and is never sent to a server. For the bigger picture, see Privacy and determinism.

Ways to load a photo

Upload from your device

There are two upload buttons, and they open the same file picker:

  1. The drop zone in the middle of the empty editor. Click it to browse your files. On a touch screen it reads "tap to choose a photo".
  2. open at the left of the bottom toolbar (on mobile the tab is called Open).

Pick a file and it loads straight onto the canvas.

Drag and drop, or paste

When no image is loaded, drag a file from your desktop or file manager anywhere onto the page. The whole window shows a dashed outline that reads "let go to open it". Drop it and it loads exactly as an upload would.

You can also paste an image from your clipboard with Ctrl / Cmd + V while the editor is empty.

Note: Drag and drop and paste work while the editor is empty. Once a photo is on the canvas, use open to swap it.

Try a sample

Under the drop zone, "no photo handy? start with one of ours" shows six sample photos. Click one to load it. Samples are handy for learning the tools before you bring your own work.

Samples behave a little differently from your own uploads:

If a file won't open

If the file can't be read as an image, a message says "That file isn't an image we can open." and suggests a JPG, PNG, WebP or HEIC. HEIC, RAW and TIFF files that fail to convert get their own message with a tip, such as exporting a JPG from your camera app first.

If you pick a second file while the first is still loading, the newer one wins and the older one is dropped.

Supported formats

The file picker accepts these types:

GroupExtensions
Common web images.jpg, .jpeg, .png, .webp, .gif, .bmp, .avif, .svg, .ico
Apple photos.heic, .heif
TIFF.tif, .tiff
Adobe DNG.dng
Camera RAW.cr2, .cr3, .crw (Canon), .nef, .nrw (Nikon), .arw, .srf, .sr2 (Sony), .raf (Fujifilm), .rw2 (Panasonic), .orf (Olympus), .pef, .ptx (Pentax), .srw (Samsung), .x3f (Sigma), .3fr, .fff (Hasselblad), .mrw (Minolta), .mef, .mos (Mamiya and Leaf), .kdc, .dcr (Kodak), .erf (Epson), .rwl (Leica), .iiq (Phase One), .raw

Common web formats load directly. The other groups are converted first, as described below. For a list that covers every workspace, see Supported files.

How conversion works

Browsers can't display HEIC, TIFF or camera RAW files on their own, so Bitgrain decodes them into a high quality JPEG before anything else happens. While that runs, a small card at the top of the screen shows progress:

FormatCard titleCard subtitle
HEIC, HEIFConverting HEIC imageDecoding Apple format to JPEG
Camera RAW, DNGConverting RAW imageDecoding camera RAW to JPEG
TIFFConverting TIFF imageDecoding TIFF to JPEG

When it finishes, the card switches to "Conversion complete" and "Loading your photo…".

HEIC and HEIF

iPhone photos are decoded and saved as a JPEG at 92% quality. The file keeps its name with a .jpg extension.

TIFF

The first image in the TIFF file is decoded and saved as a JPEG at 95% quality. If your TIFF holds several pages or layers, only the first one is used.

Camera RAW and DNG

RAW files are developed in the browser and saved as a JPEG at 95% quality:

RAW development is heavier than a normal upload, so large files can take a few seconds. If a file can't be decoded, the progress card closes and a message suggests exporting a JPG or TIFF from your camera app instead.

Size normalization

To keep the editor fast and within browser memory limits, any image whose long edge is larger than 8192 pixels is scaled down so the long edge is exactly 8192 pixels, then saved as a JPEG at 95% quality. The aspect ratio never changes. Images at or below 8192 pixels on the long edge are used as they are.

GIF and SVG files skip this step.

Tip: 8192 pixels is far more than the effects need. The look is computed on a smaller working grid controlled by the Detail slider, which is explained in Adjustments. Your export is then scaled back up toward your photo's original size.

After the image loads

When a new photo lands on the canvas:

If you opened a recipe link before adding a photo, a banner reads "Recipe loaded, add a photo to apply it". The recipe is applied to the first photo you open instead of the starting look, and a message confirms "Recipe applied". Click the cross on the banner to discard it.

Coming back later

Your current look is saved in your browser as you work, and restored along with your photo when you reload or come back. Tone masks are not part of this, and painted mask areas are cleared when a new photo is loaded.

If you try to close or reload the tab with changes you haven't exported yet, your browser asks you to confirm before leaving.

Tip: Browser storage is tied to one browser on one device. To keep a look for good or use it elsewhere, save it as a preset, copy a recipe link, or save a .btg project. See Presets and recipes.

Replacing an image

To work on a different photo, click open while an image is loaded. The new photo replaces the old one and the look resets, as described above.

If you want the same look on a new photo:

  1. Before switching, save the current look as a preset (open presets, then Save current as preset) or copy a recipe link from the export panel.
  2. Open the new photo.
  3. Apply your saved preset, or open the recipe link.

Opening a .btg project

A .btg file saved from the image editor holds your image and its main settings. To open one, click open project (the folder icon in the canvas tools at the top left, desktop only) and choose the file. The image and its effect, dither, adjustment, colour, built-in palette, film grade and haze settings are restored. .btg import and export are free on every plan.

Cropping before you edit

Click crop in the canvas tools (or the crop icon on mobile) to trim the photo. The Crop image dialog opens with a row of shapes: Free, 1:1, 4:5, 9:16 and 16:9. Picking a shape centers the largest box of that shape on the photo and keeps the shape while you resize. Drag a corner handle to resize the box or drag inside it to move it, then click Apply crop. Reset brings back the full frame and the free shape. The live readout under the image shows the size of the box in real image pixels, so it matches the size of the file you'll get.

Cropping replaces the working photo with the cropped version. The cropped photo is saved to browser storage, so it's still there after a reload, and exports use the cropped size. Cropping a sample turns it into your own working image. Cropping isn't part of undo, so to get the full frame back, open the original again.

Removing the background

Click the scissors icon (Remove background) in the canvas tools, or Cut out on mobile, to lift the subject off its background. It works best on a clear subject such as a person, a pet or a product.

It runs entirely on your device. Nothing is uploaded. The first time you use it, your browser downloads a small cut-out model (about 4.6 MB) and keeps it, so later cut-outs start right away and work offline. A card in the corner shows the download and then "finding the subject" while it works.

The cut-out replaces the working photo with a PNG that has a transparent background, so effects and PNG or WebP downloads keep the transparency. Pixel effects such as grades, halftone and LUTs keep it too. Text effects like ASCII and Braille, and dithering, draw their own paper, so they fill the background in. JPEG downloads have no transparency.

Changed your mind? Click Undo on the message that appears, or press Cmd / Ctrl + Z. If your browser runs out of memory on a very large photo, you'll see a message suggesting a smaller image.

Clearing the canvas

Click clear image (the bin icon) to remove the image and return to the empty state. A message reads "Image cleared" with an undo button, so you can bring it back if you change your mind. Once that message goes away, the stored copy is removed from your browser too.

More documentation