How to Use the Mosaic Tool
Is this tool free to use?
Yes, completely free with no account required, no ads, and no limits on how many mosaics you generate!
What is a stud in LEGO terms?
A stud is the small circular bump on top of a LEGO brick. It is also the standard unit of measurement used in LEGO building. One stud equals 8mm (0.8cm) in real life.
When you set your mosaic to 48×48 studs, for example, your finished build will measure approximately 38.4cm × 38.4cm.
How does the LEGO mosaic tool work?
Upload any image in JPG or PNG format, set your desired width and height in studs, choose how many colours you want to limit the palette to, then click Generate Mosaic.
The tool analyses each pixel of your image, maps it to the closest available LEGO colour, and renders a stud-by-stud mosaic preview with a numbered colour map and a full colour list.
What image size or resolution should I upload?
Any resolution works! The tool automatically scales your image down to the stud grid you set. For best results, use a clear image with good contrast and distinct colours.
Simple graphics, portraits with plain backgrounds, and logos tend to produce better mosaics than busy, highly detailed scenes.
What LEGO colours does the tool use?
The tool uses the current active LEGO colour palette as of 2025–2026, sourced from BrickLink's colour guide.
Only solid, opaque colours are included. Transparent, metallic, and pearl colours have been excluded since they are rarely used in mosaic builds and are harder to source in large quantities.
How many colours should I set for my mosaic?
For a clean, buildable mosaic, 10 to 16 colours is a good starting point. Using too many colours makes the build harder to follow and more expensive to order. Using too few can make the image unrecognisable.
The tool lets you set between 2 and 30 colours, experiment to find the right balance for your image.
Can I swap or remove colours from the mosaic?
Yes. After the mosaic generates, a Swap or Remove Colours panel appears below it. Each colour in your palette shows three closest alternative colours you can switch to with one click.
You can also remove a colour entirely, the tool will reassign those pixels to the next closest available colour and regenerate the mosaic instantly.
Why would I want to remove a colour?
You might want to remove a colour that is hard to find, discontinued in your country, too expensive, or simply not available in your current brick collection.
Removing it forces the tool to use your remaining colours, giving you a mosaic you can actually build with what you have or can easily order.
What is the maximum mosaic size I can build?
The tool supports up to 96×96 studs. At 1 stud = 8mm, a 96×96 mosaic would measure approximately 76.8cm × 76.8cm — a very large wall display piece. For a first build, 32×32 or 48×48 is a manageable starting size.
What do the numbers in the number map mean?
Each colour in your mosaic is assigned a unique number. The number map shows your entire mosaic as a grid of numbers, where each cell's background colour matches the LEGO colour it represents.
This is your building guide, you follow it row by row, placing the correct coloured stud at each position.
Can I export my mosaic?
Yes, there are three export options.
Export Mosaic PNG saves a high-resolution image of your rendered mosaic with stud dots.
Export Numbered PNG saves the full number map as a PNG file you can print and use as a building guide.
Export Colour List CSV downloads a spreadsheet with each colour name, HEX code, stud count, and percentage, useful for ordering bricks on BrickLink or other suppliers.
Collapsible row
Troubleshooting
Why does my mosaic not look like my original image?
LEGO has a limited colour palette compared to the millions of colours in a photograph. The tool finds the closest available LEGO colour for each pixel, which means some colour information is lost.
Images with strong contrast, bold colours, and simple compositions will produce the most recognisable results. Try adjusting the stud count or increasing the max colours to improve fidelity.
Does the tool work on mobile?
While the tool loads and works well on mobile devices, it is preferred to use a desktop to be able to look into the mosaic better and customize the result before exporting them.
Data & Privacy
Is my uploaded image stored or sent to a server?
No. We honestly don't know what image you'll be using to make a mosaic.
All processing happens entirely in your browser. Your image is never uploaded to any server, stored, or transmitted anywhere. The tool runs 100% client-side using JavaScript and the HTML5 Canvas API.
Can I build my own portrait with this tool?
You're safe to use this tool for portraits or your own photos. Portraits are one of the most popular mosaic subjects.
For best results use a photo with a plain or blurred background, good lighting, and strong contrast between the subject and background. Set the max colours to around 12–18 and use a size of at least 48×48 studs for recognisable facial detail.
Why is this tool free?
It's a simple tool that doesn't require server processing. We simply want to give LEGO MOC Designers around the world, a hassle-free experience when planning for their next challenge.
Check out our other free tools here