
An Aseprite Reference Layer is intentionally not drawable or editable. It can display a reference image at a higher resolution than the sprite canvas. Use a separate artwork layer for the pixels you intend to draw, and keep the reference as a visual source rather than treating it as converted pixel art.
Key Takeaways
- Reference Layers can show higher-resolution source images.
- The documented layer type cannot be painted on or edited.
- Reference display and finished sprite pixels have different purposes.
Identify the layer before changing the file
If the brush appears to do nothing on an imported photograph, first inspect whether it was added as a Reference Layer. Do not assume the photograph is corrupt or resize the whole sprite just to make that layer editable.
The Aseprite Reference Layer documentation explicitly describes the non-editable behavior. It documents Layer > New > New Reference Layer from File and Edit > Paste Special > Paste as New Reference Layer as creation routes.
- Save the .aseprite master and keep the authorized source photograph.
- Identify the reference layer and its intended visual role.
- Select or create a suitable normal artwork layer for drawing.
- Draw a small, reversible mark on that artwork layer to confirm the correct target.
- Build the sprite while reviewing composition against the reference.
These are proposed checks. The cited reference-layer page does not document a conversion command that makes a Reference Layer editable, so this guide does not invent one.
A hypothetical portrait-icon workflow
Suppose a creator uses a large authorized portrait as a reference for a small avatar. The reference can preserve visible facial and clothing cues while the new pixel drawing uses a deliberately restricted grid.
The photograph has not become a game-ready sprite merely because it is visible in the same editor. Its fine detail and the drawn asset's discrete pixels remain different resources.
The pixel-art versus Riso planning guide helps choose a visual direction. This workflow addresses where to draw after that decision, not an automatic photo-conversion feature.
Inspect the actual deliverable
Review the artwork at its base size and at an enlarged hard-edge view. Check that the output contains the intended drawn pixels, that the reference has not been mistaken for completed artwork and that required transparency remains correct.
Keep the layered master and a clearly identified export separately. If the exported file contains unexpected content, inspect the actual export scope and layer choices rather than asserting that a reference display proves the final asset's composition.
Accept when the working target is editable and the delivered sprite satisfies its grid and visual brief. A read-only reference is a useful tool state, not evidence that the source image has already been transformed into editable pixel artwork.
Related tasks
- Photo to Pixel Art or Riso: Choose the Right Transformation
- Is a Photo-to-Pixel-Art Effect the Same as a True Pixel-Perfect Image?
- What Is the Difference Between an Editable Artwork Master and a Flat PNG?
Sources and scope
- Aseprite Reference Layer: Reference Layers can display higher-resolution images and cannot be drawn on or edited; documented file and clipboard creation routes.
Documentation-based guidance. Scenarios, worksheets and acceptance procedures are proposed or hypothetical; no hands-on test, benchmark, search-volume measurement or AI-citation ranking is claimed.
Prepared by Imagild Editorial, the company editorial team responsible for these guides. AI assisted research and drafting. This is documentation-based guidance with proposed examples, not a claim of hands-on testing or an independent product review. Report a correction.
Cover: AI-generated conceptual editorial illustration; not a real application screenshot, observed output or before-and-after test.