Skip to content

Troubleshooting

If Kleki only shows “Loading”, or “Failed to load Kleki. Please reload.”, do a hard reload:

SystemBrowserShortcut
Windows / LinuxChrome, Edge, FirefoxCtrl + Shift + R or Ctrl + F5
Windows / LinuxOperaCtrl + Shift + R
macOSChrome, Edge, Firefox, OperaCmd + Shift + R
macOSSafariCmd + Option + R

If Kleki says “Kleki failed to initialize”, try these steps:

  1. Do a hard reload (see above).
  2. Close the tab, clear the browser cache for kleki.com, and open Kleki again.
  3. Update your browser.
  4. Try again later, in case the problem is temporary.

If none of that works, contact me.

Kleki is stored on your device so it also works offline. Sometimes the old version stays for a while after an update. Close all Kleki tabs and open Kleki again, or do a hard reload.

  1. Look in File > Recover closed tabs. See Tab Recovery.
  2. Look in Browser Storage in the File tab, if you stored your drawing there.
  3. Check your Downloads folder for saved files.

A tab has no recovery, or lost it, if:

  • the drawing was only a few minutes old
  • the recovery is older than 7 days, or newer recoveries replaced it
  • you’re in a different browser or browser profile, or in a private window
  • your browser’s data for kleki.com was deleted, for example because:
    • you cleared your browsing data, including cookies and site data
    • your browser is set to delete site data when you close it
    • a cleanup or privacy app removed it
    • Safari removed it because you hadn’t opened Kleki for 7 days
    • your device ran low on storage

Your browser’s memory saver probably unloads the tab. See Prevent Browser Refreshes.

Check your free disk space and that your browser is allowed to download files. See If Saving Fails.

Saved files go to your Downloads folder. In Chrome and Edge, turn on Show save dialog in the File tab to choose the folder yourself.

Your browser blocked the other downloads. Allow kleki.com to download multiple files, then save again.

JPG can’t store transparency, and transparent areas turn black. Save as PNG instead, or fill the bottom layer with a color before saving.

Websites and apps show small images enlarged, and most of them smooth the pixels while doing so. Enlarge your pixel art in Kleki before you save or upload it: in the Edit tab, use Resize, choose Pixelated, and click 2×. Repeat for 4× or 8×. Doubling keeps every pixel sharp and square.

”Can’t Access Storage” or “Failed to Store”

Section titled “”Can’t Access Storage” or “Failed to Store””
  • Private and incognito windows usually block storage. Use a normal window.
  • Your device may be out of disk space.
  • Privacy settings or an extension may block storage for kleki.com.

See If Storing Fails.

The Paint Bucket Leaves White Pixels Around My Lines

Section titled “The Paint Bucket Leaves White Pixels Around My Lines”

Lines have soft edges, and the bucket stops before the faint pixels along them, even when there are no gaps. Set Grow to 1 or 2 in the bucket settings, so the color reaches under the line. This works best with the line art on its own layer above the colors. See Grow.

  • Lower Tolerance. Kleki starts with 20%. With dark colors, such as black hair next to black lines, a lower value keeps the fill inside.
  • Check your line art for gaps. Even a 1-pixel gap lets the fill escape.
  • With Sample: Active on an empty layer, the fill covers the whole layer. Switch back to All.

See Fix Leaking Fills.

By default (Sample: All), the bucket looks at all layers together, as you see them, so a background or shading on another layer can stop the fill. Put the line art on its own layer above the colors, select the colors layer, and set Sample to Above. The bucket then only looks at the line art. See Sample.

You’re erasing on the bottom layer, which works like paper. Turn on Transparent Background in the Eraser settings. See The Bottom Layer and How do I make a transparent background?

  • Check the pressure toggle next to each slider. Size, opacity, and scatter have separate toggles. See Pen Pressure.
  • Sketchy and Chemy don’t support pressure.
  • Your browser or tablet driver must pass pressure to the browser. Update both. On Windows, many tablets need Windows Ink turned on in the tablet settings.
  • Try another browser.

When you draw with a stylus on a touch screen, your hand can touch the screen too. Kleki then reacts to it: it draws, moves the view, or undoes something (a two-finger tap undoes). Many tablets ignore a resting palm, but not always.

Wear a drawing glove. These thin gloves cover the side of your hand and your last two fingers, and are sold as “digital art gloves” or “drawing gloves”. A fingerless glove works too.

  • Switch to another window and back, for example with Alt + Tab. This helps when Kleki acts as if a key is still held down.
  • A browser extension may use the same keys.
  • Ctrl + Alt (HUD) may be taken by your operating system or keyboard layout.

See Shortcuts Not Working?

You zoomed the browser page instead of the canvas. Double-tap, or pinch in, to reset it. Kleki shows a hint when this happens.

Kleki has a limit of 16 layers. Merge layers you’re done with: Merge with layer below, or Merge all in the layer More menu. See Layers.

It was larger than the maximum canvas size of 2048 × 2048 pixels, so Kleki scaled it down. See Canvas Size.

My PSD Looks Different, Was Flattened, or Won’t Open

Section titled “My PSD Looks Different, Was Flattened, or Won’t Open”

Kleki doesn’t support every Photoshop feature. Try importing with Flatten image turned on. See Opening PSD Files.

Convert the file to PNG or JPEG, then import it. See Supported Formats.

The website doesn’t allow other sites to load its images. Download the image, then import the file.

If your browser can’t copy images directly, the dialog says “Right-click or press hold to copy.” Right-click (or long-press) the preview and choose copy.

Imported fonts are only kept until you reload Kleki. Import the font again.

The Edit tab says “Features disabled because WebGL is failing.” See Filters Are Disabled.

  • Large canvases and many layers need a lot of memory. Merge layers you don’t need anymore, or work on a smaller canvas.
  • Very large brushes are slower.
  • Close other heavy tabs and apps.
  • Make sure hardware acceleration is on in your browser.

Send feedback with the Feedback button in the Settings tab, report a bug on GitHub, or contact me.