Troubleshooting
Loading and Updates
Section titled “Loading and Updates”The App Does Not Load
Section titled “The App Does Not Load”If Kleki only shows “Loading”, or “Failed to load Kleki. Please reload.”, do a hard reload:
| System | Browser | Shortcut |
|---|---|---|
| Windows / Linux | Chrome, Edge, Firefox | Ctrl + Shift + R or Ctrl + F5 |
| Windows / Linux | Opera | Ctrl + Shift + R |
| macOS | Chrome, Edge, Firefox, Opera | Cmd + Shift + R |
| macOS | Safari | Cmd + Option + R |
Failed to Initialize
Section titled “Failed to Initialize”If Kleki says “Kleki failed to initialize”, try these steps:
- Do a hard reload (see above).
- Close the tab, clear the browser cache for
kleki.com, and open Kleki again. - Update your browser.
- Try again later, in case the problem is temporary.
If none of that works, contact me.
Kleki Looks Old or Didn’t Update
Section titled “Kleki Looks Old or Didn’t Update”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.
Lost Work
Section titled “Lost Work”My Drawing Is Gone
Section titled “My Drawing Is Gone”- Look in File > Recover closed tabs. See Tab Recovery.
- Look in Browser Storage in the File tab, if you stored your drawing there.
- Check your Downloads folder for saved files.
My Recovery Is Missing
Section titled “My Recovery Is Missing”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
The Tab Keeps Refreshing
Section titled “The Tab Keeps Refreshing”Your browser’s memory saver probably unloads the tab. See Prevent Browser Refreshes.
Saving and Storage
Section titled “Saving and Storage”Saving Does Not Work
Section titled “Saving Does Not Work”Check your free disk space and that your browser is allowed to download files. See If Saving Fails.
Where Did My File Go?
Section titled “Where Did My File Go?”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.
Layers (PNG) Only Saved One File
Section titled “Layers (PNG) Only Saved One File”Your browser blocked the other downloads. Allow kleki.com to download multiple files, then save again.
My JPG Has a Black Background
Section titled “My JPG Has a Black Background”JPG can’t store transparency, and transparent areas turn black. Save as PNG instead, or fill the bottom layer with a color before saving.
My Pixel Art Looks Blurry After Uploading
Section titled “My Pixel Art Looks Blurry After Uploading”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.
Paint Bucket
Section titled “Paint Bucket”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.
The Paint Bucket Fills Too Much
Section titled “The Paint Bucket Fills Too Much”- 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.
The Paint Bucket Reacts to Other Layers
Section titled “The Paint Bucket Reacts to Other Layers”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.
Drawing
Section titled “Drawing”The Eraser Paints White
Section titled “The Eraser Paints White”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?
Pen Pressure Doesn’t Work
Section titled “Pen Pressure Doesn’t Work”- 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.
My Hand Causes Stray Marks or Zooming
Section titled “My Hand Causes Stray Marks or Zooming”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.
Shortcuts Don’t Work
Section titled “Shortcuts Don’t Work”- 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.
The Whole Page Is Zoomed In
Section titled “The Whole Page Is Zoomed In”You zoomed the browser page instead of the canvas. Double-tap, or pinch in, to reset it. Kleki shows a hint when this happens.
Layers and Files
Section titled “Layers and Files”I Can’t Add More Layers
Section titled “I Can’t Add More Layers”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.
My Imported Image Got Smaller
Section titled “My Imported Image Got Smaller”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.
”Unsupported File Type”
Section titled “”Unsupported File Type””Convert the file to PNG or JPEG, then import it. See Supported Formats.
Pasting an Image Link Does Nothing
Section titled “Pasting an Image Link Does Nothing”The website doesn’t allow other sites to load its images. Download the image, then import the file.
Copy to Clipboard Doesn’t Work
Section titled “Copy to Clipboard Doesn’t Work”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.
My Imported Font Is Gone
Section titled “My Imported Font Is Gone”Imported fonts are only kept until you reload Kleki. Import the font again.
Performance
Section titled “Performance”Filters Are Disabled
Section titled “Filters Are Disabled”The Edit tab says “Features disabled because WebGL is failing.” See Filters Are Disabled.
Kleki Is Slow
Section titled “Kleki Is Slow”- 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.
Still Stuck?
Section titled “Still Stuck?”Send feedback with the Feedback button in the Settings tab, report a bug on GitHub, or contact me.