MC ToolboxMC TOOLBOX

April 18, 2026

Custom Paintings in Minecraft: Canvas Sizes & Resource Packs

Turn your custom digital artwork into in-game Minecraft paintings for Java 1.21+ and Bedrock Edition.

In Minecraft 26.x, Mojang added support for custom painting variants via datapacks and resource packs! You no longer have to replace original painting textures like KZ.png.

Painting Canvas Aspect Ratios

Minecraft paintings use pixel dimensions in multiples of 16:

Minecraft custom painting resource pack artwork canvas preview
Screenshot from the matching MC Toolbox tool.
  • 1x1 (16x16 px): Small portraits and signs.
  • 2x1 (32x16 px) / 1x2 (16x32 px): Landscape and vertical banners.
  • 2x2 (32x32 px): Medium square art.
  • 4x3 (64x48 px) / 4x4 (64x64 px): Wall murals.

Adding Custom Paintings in Minecraft 26.x (26.1/26.2)

In Java 1.21, custom paintings are registered under data/namespace/painting_variant/my_art.json:

{
  "asset_id": "my_namespace:my_art",
  "width": 2,
  "height": 2
}

Convert any PNG image into a ready-to-use painting pack with our Custom Paintings Pack Converter!

Gio Nui

Gio Nui

I'm an independent developer and long-time Minecraft creator. Since 2011, I've been focused on building high-performance, browser-based tools for the community.

More Guides