GIMP brush not painting? Check the target, selection and brush
Find out whether the document, brush settings or input device is hiding the stroke before resetting the application.

If your GIMP brush isn't painting, select just one visible image layer, save any selection you need and clear it, then choose an ordinary round brush with Mode: Normal, Opacity: 100 and Enable dynamics switched off. Pick a foreground colour you can see against the image, then draw with the mouse without holding a modifier key. I'd establish that plain stroke before resetting anything: the result separates a document restriction from a brush or input problem.
Make one visible stroke without damaging the edit
Save the working project as an XCF first. If Quick Mask is active, turn it off with Select → Toggle Quick Mask before continuing. Keep a selection you need with Select → Save to Channel, then choose Select → None. Saving the selection before clearing it matters when you've already spent time refining an edge.
- Create a separate paint layer. Choose Layer → New Layer…, name it Brush check and use Fill With: Transparency. Check that its width and height match the image. Place it at the top level of the stack, above the other layers and outside any group. Select only that new layer.
- Make the layer visible. Enable its eye icon, use Mode: Normal and Opacity: 100 in the Layers dialog, and leave its pixel and alpha locks off. A new layer created inside a hidden group isn't a useful control.
- Choose Paintbrush explicitly. Use Tools → Paint Tools → Paintbrush, or press P while the canvas has focus. Double-click the Paintbrush icon if Tool Options isn't visible.
- Use a simple brush setup. Select an ordinary round brush, such as 2. Hardness 050, rather than the Clipboard Brush. Set the paint mode to Normal, opacity to 100 and force to 50. Choose a visible size; 80 pixels is a starting example, not a required value. Switch off Enable dynamics.
- Choose a contrasting foreground colour. Click the foreground swatch in the Toolbox and pick a colour unlike the area behind the stroke. Use the mouse to drag a short line across the canvas, with Ctrl, Command, Alt and Shift released.
These are temporary diagnostic choices. Keep the brush settings that suit the finished edit once you've found the restriction.

If the stroke appears: the selected brush and mouse can paint under these conditions. Go back to the original target and use the matching check below. If it doesn't: make a separate image with File → New…, keep a plain background, select its image layer and repeat the contrasting-colour stroke. A working new image points back towards the original document. Failure in both images sends you to the brush settings and input checks.
Follow the symptom you can see
| What happens | Check next |
|---|---|
| A warning or barred cursor appears | Read the status bar. Select one paintable layer, then inspect pixel locks, visibility and any unfinished floating selection. |
| A mark appears in the thumbnail but not on the canvas | Check layers above, the layer's mask, parent groups, and the separate layer mode and opacity. |
| Only part of the image accepts paint | Preserve and clear the selection, then inspect the layer boundary and alpha lock. |
| Painting changes an overlay or a mask | Exit Quick Mask, or click the image thumbnail instead of the mask/channel target. |
| The brush paints the wrong colour | Check the target, foreground swatch, brush type, dynamics and Image Mode. |
| The mouse paints but the stylus doesn't | Keep the working layer and brush settings. Compare the stylus with dynamics off before investigating its input configuration. |
Select one layer, then its image or mask
Open Windows → Dockable Dialogs → Layers. In GIMP 3, several highlighted rows don't mean that Paintbrush will paint on them together. The Layers dialog explains the single-layer restriction for painting. Click the intended image thumbnail without a selection modifier and confirm that only its row remains selected.
A layer group is a container. Select a child image layer or add an ordinary layer inside the group when that is where the paint belongs. If the status bar reports a group or multiple-layer restriction, changing brush size won't fix the target. An unfinished Floating Selection needs attention too: Layer → To New Layer preserves that paste as an ordinary layer. Decide which layer you want before painting again.
A layer with a mask has two thumbnails. Click the image thumbnail to add coloured pixels; click the mask thumbnail to change visibility. The active thumbnail has a border, which can be hard to distinguish around a white mask.
Painting black on a white mask hides that part of the layer; painting white restores visibility where underlying pixels exist. White paint over an already white mask produces no visible change. A mask can't restore pixels that were erased from the image layer. Use the layer-mask workflow when the intended change is which part of the photograph shows.
Check Layer → Mask → Disable Layer Masks if edits to a mask don't affect the composite. A red thumbnail border marks a disabled mask whose effect is temporarily switched off; use the same command to enable it again. Show Layer Masks is a different state: it displays the mask itself, with a green thumbnail border. Toggle that command off to return to the composite. Don't delete or apply the mask to diagnose either state.
Find what is hiding an otherwise valid stroke
Tool opacity controls the brush operation. Layer opacity controls how the layer appears in the composite. Both can make a mark invisible, and changing one doesn't repair the other. Check the selected layer's eye icon, opacity and mode, then check the same properties on its parent groups. Finally, look for an opaque layer above the one receiving the paint.
I'd keep the Brush check layer above everything while comparing these settings. Moving the control into the same hidden group as the original recreates the restriction and obscures the diagnosis.
Paint mode and layer mode are separate too. In the paint-tool mode examples, Behind affects transparent areas rather than opaque ones, while Color Erase can remove the chosen colour on a layer with alpha. If the brush erases instead of adding colour, return its paint mode to Normal for the check. For a stroke that exists in the thumbnail but looks unexpected in the composite, inspect the layer's mode separately.
Read any message after a failed stroke. The official troubleshooting sequence puts the status bar, Tool Options, selected target and layer attributes ahead of broader changes. A message about a selected or invisible layer is more useful than another reinstall.
Clear the restriction, not the image structure
An active selection restricts where the brush can work even when its outline is hidden or too small to notice. In a documented GIMP Chat case, Paintbrush worked in another image and appeared in undo history, but the original image showed no mark; the poster confirmed that Select → None cleared an unnoticed selection and solved it.
Keep an important selection with Select → Save to Channel before clearing it. If you want to inspect the selection first, open Select → Selection Editor: white areas are selected, black areas are excluded and grey areas are partly selected. Avoid clicking inside its preview, because the Selection Editor's display is also interactive. For the plain-stroke check, exit Quick Mask and choose Select → None even if you can't see marching ants.
A coloured overlay can mean that you're painting the selection itself. In Quick Mask mode, paint operations change the selection channel: white adds selected pixels and black removes them. Use Select → Toggle Quick Mask to leave that mode before painting image pixels. If a saved channel is the editing target, return to Layers and click the intended image thumbnail.
Next inspect the selected layer's lock controls:
- Lock pixels prevents brush-based editing. Temporarily release it only on the target you intend to change.
- Lock alpha channel preserves transparency. It lets you recolour existing opaque pixels, but it won't let a stroke make a fully transparent area visible. A new empty layer with alpha locked is therefore a poor paint target.
- Lock position and size protects movement and transforms; it isn't the same as locking pixels. Leave useful protection in place when it doesn't block the intended operation.
Layers also have their own boundaries. A small pasted layer doesn't automatically cover the canvas. By default, painting outside a layer's boundary is ignored. Use a full-image paint layer, deliberately enlarge the relevant layer boundary, or enable Expand Layers in the current Paintbrush options when growth is intended. Expand Layers stops at the image canvas; it doesn't remove a selection or override an alpha lock.
Check the brush itself and the colour it should paint
A brush preview isn't a guarantee of a useful mark. Open Tool Options by double-clicking Paintbrush and choose the ordinary round brush used in the control. The empty Clipboard Brush check explains a specific failure: the selected brush contains no clipboard image. Choosing a different installed brush is enough to isolate that case; you don't need to refill the clipboard or replace the installation.
Use a visible size and inspect the image at a useful zoom. With a very small brush on a large photograph, a faint mark can be difficult to find. Force is another control on stroke strength: the current paint-tool reference describes values below 50 as reducing the brush's effect relative to its preview. The control uses 50 as a neutral diagnostic value, not as a prescription for every painting task.
If the brush paints but ignores the colour you've chosen, check these distinctions before changing the image mode:
- Foreground colour: Paintbrush uses the foreground swatch for ordinary brushes. Painting white on white is still painting. Pick a contrasting colour in the swatch rather than relying on the colour of a previous stroke.
- Colour brush: a brush made from a coloured image can stamp its own colours. The ordinary and colour brush descriptions distinguish this from a greyscale brush that takes the foreground colour.
- Dynamics: a preset can control colour, opacity or size from pressure, speed, fade or other inputs. Switch off Enable dynamics for the comparison; a colour-dynamics mapping can use the active gradient.
- Target and channels: a mask or saved selection channel is greyscale. For image pixels, open Windows → Dockable Dialogs → Channels if colour components look wrong. The channel-selection controls affect which components painting changes; channel visibility only changes the display.
Inspect Image → Mode if the intended image really is greyscale or indexed. Those modes have different colour limits from RGB. Convert a separate copy through Image → Mode → RGB when the task needs full-colour editing; don't alter a deliberately indexed deliverable just to conceal the actual brush problem.
Separate a modifier or tablet problem from a brush problem
If the cursor samples colour instead of drawing, release the colour-picker modifier shown in the status bar: normally Ctrl on Windows/Linux, or Command on macOS. The paint tool uses the platform modifier for temporary colour picking. Following the on-screen hint avoids confusing canvas colour picking with a modified click on a mask thumbnail.
A thin guide line that follows the pointer can be straight-line mode. For freehand drawing, release Shift. To paint a straight line deliberately, click the starting point, hold Shift and click the endpoint; moving the pointer alone only positions the guide.
When the mouse works but the stylus doesn't, keep the same visible layer, foreground colour and ordinary brush. Try the stylus with Enable dynamics off, then enable the intended preset only after it makes a mark. Paint dynamics map input to settings such as opacity and size, so this comparison separates ordinary painting from the preset's response. It doesn't prove that the tablet driver is faulty.
If the stylus still fails with dynamics off while the mouse works, investigate the device configuration for that GIMP version and operating system. Note whether the pen moves the cursor, whether a press creates a mark, and whether pressure changes the result. Keep those observations distinct; each narrows a different part of the input problem.
Reset the active tool only when the control still fails
Save a useful custom setup through Save Tool Preset… before replacing it. At the bottom of Tool Options, use Reset to default values for the active Paintbrush. Avoid holding Shift: the reset-button documentation says Shift resets all tools. Select the ordinary brush and repeat the contrasting mouse stroke, because a reset isn't a substitute for a visible target and foreground.
If painting still fails in a fresh image after that check, collect the exact GIMP version, operating system, input device, status-bar message and whether the mouse and stylus differ. A screenshot for a support request should show the canvas, Tool Options and Layers dialog together, with private images hidden or replaced by a harmless example. Those details make a support discussion actionable; “the brush doesn't work” leaves the target and settings unknown.
Once the cause is clear, remove the Brush check layer, restore the intended selection and reinstate any useful lock or dynamics preset. Make the next real stroke on the correct image or mask target and save the XCF. If the remaining problem is specifically erasing to transparency, continue with the eraser and alpha-channel checks.



