Image Tracer Open the app

Documentation16 min read

Image Tracer documentation

Everything Image Tracer does, setting by setting: what each control changes, its default and range, when to move it, and what ends up in the SVG you download. Keep it open next to the editor while you work.

  • No account required
  • No watermark
Image Tracer
Black & whiteColour
Threshold
Blur0
Smoothness1
Curve optimisation0.2
Ignore less than2
Download SVG
1Mode 2Settings 3Live preview 4Export
Original low-resolution image The same image traced into an SVG vector Before · PNGAfter · SVG · 4 shapes
Drag to compareTraced by Image Tracer: 4 editable shapes, 444 nodes, 7.6 KB.

Getting started

Image Tracer converts a raster image (pixels) into an SVG (shapes). It runs entirely in your browser, so there is nothing to install and no account to create.

  1. Open Image Tracer and load an image: click Open image, click the drop zone, drag a file onto the page, or paste an image with Ctrl+V (Cmd+V on a Mac).
  2. Pick a mode with the tabs at the top of the settings panel: Black & white for one-colour artwork, Colour for anything with several flat colours.
  3. Adjust the settings. Every change re-traces automatically after a short pause, so you see the effect straight away.
  4. Check the result in the preview, zoom in, and look at the node count in the status line.
  5. Click Download SVG or Copy SVG.

Supported input formats are PNG, JPEG, WebP, GIF and BMP. SVG files are not accepted, because they are already vectors.

The defaults are chosen to give a faithful trace of clean artwork, so for a crisp logo or icon you may not need to touch anything. If you have changed things and want to start over, Restore default settings at the bottom of the panel puts every control back. It is greyed out while everything is already at its default.

Settings at a glance

SettingModeDefaultRangeIn one line
Invert imageB&WOffOn / offTrace the light parts instead of the dark ones
BlurB&W00 and up (px radius)Soften noise and texture before thresholding
ThresholdB&WAutomatic0–255Brightness that separates ink from background
OutputColourSeparate shapesSeparate shapes / Stacked layersHow colour regions are built into paths
Number of coloursColour82–32Maximum size of the palette
Remove backgroundColourOffOn / offDrop the background region touching the edges
Ignore less thanBoth20 and up (px²)Remove specks and pinholes below this area
SmoothnessBoth10–1.34Which turns stay corners and which become curves
Curve optimisationBoth0.20 and upAccuracy versus number of nodes
Max size (px)Both20481024 / 2048 / 4096 / FullWorking resolution the image is traced at

Modes: Black & white and Colour

The two tabs run two different pipelines, and the settings panel only shows the controls that apply to the active one.

Black & white

The image is turned into greyscale, optionally blurred, then split into ink and background at the threshold. The resulting mask is traced into black shapes. Transparent areas are treated as white, so a logo on a transparent background traces cleanly with no extra work.

Use it for logos in one colour, text, signatures, line art, stamps, scanned drawings and anything you will recolour later anyway. It is the fastest mode and gives the fewest nodes.

Colour

The image is reduced to a small palette (up to the Number of colours) and every region of each colour is traced. Soft anti-aliased edges are cleaned up first, so the grey fringe between a black outline and a white fill does not turn into a thin sliver shape, and each fill colour is measured from the inside of its region rather than from blended edge pixels. Fully transparent areas are left empty.

Use it for flat illustrations, multi-colour logos, icons, stickers and cartoons. For a deeper comparison see Black & white vs colour tracing.

Black & white settings

These three controls decide which pixels count as ink. The Processed image view shows the exact mask they produce, which is the quickest way to judge them.

Invert image

Default: off.

Real output · 2 settings comparedInvert traces light artwork on a dark background
Invert off: 20 shapes
Invert off20 shapes
Invert on: 46 shapes
Invert on46 shapesRecommended
A light logo on a dark board. Without Invert the tracer outlines the dark board around the artwork; with Invert on it traces the artwork itself.

Normally dark pixels are traced and light pixels are background. Invert swaps that: light pixels become the shapes. Turn it on for white chalk on a blackboard, a white logo on a dark banner, or a negative scan. If your trace looks like a black rectangle with your artwork cut out of it, Invert is almost always the fix.

Blur

Default: 0 (off). Range: 0 upwards, in pixels of radius; decimals are fine (1.5 or 1,5).

Real output · 3 settings comparedBlur smooths paper texture before tracing
Blur 0: 209 shapes
Blur 0209 shapes
Blur 1: 157 shapes
Blur 1157 shapesRecommended
Blur 2.5: 149 shapes
Blur 2.5149 shapes
A noisy phone scan of a sketch, with Ignore less than set to 0 to show the raw effect. A little blur melts paper grain into the background; too much starts to soften thin lines.

Blur applies a gaussian blur to the greyscale image before the threshold. It removes paper grain, JPEG blockiness and halftone dots, and it rounds off ragged edges so they trace as smooth curves. It takes effect when you press Enter or leave the field.

  • Raise it (1–2) for phone photos of drawings, textured paper, noisy JPEGs or edges that look chewed.
  • Keep it at 0 for clean digital artwork, small text and pixel art, where blur only rounds corners and fills in small gaps.

Example: a pencil sketch photographed on cartridge paper traces with hundreds of tiny specks at 0. At a blur of 1.5 the grain disappears and the strokes become single solid shapes. Going much higher starts to merge nearby lines and close up the counters of small letters.

Threshold

Default: automatic. Range: 0–255.

Real output · 3 settings comparedThreshold decides what counts as dark
Threshold 70: 5 shapes
Threshold 705 shapes
Automatic (155): 3 shapes
Automatic (155)3 shapesRecommended
Threshold 200: 2 shapes
Threshold 2002 shapes
The same colour illustration traced in Black & white mode. A low threshold keeps only the darkest areas; a high one swallows mid-tones. The automatic value is picked from the image's histogram.

Every pixel darker than the threshold becomes ink. When an image loads, Image Tracer picks a value automatically for that image using Otsu's method, which finds the split that best separates the two main brightness groups. The histogram under the slider shows how many pixels sit at each brightness, with a line marking the current threshold. Clean artwork has two clear humps (ink and paper) and the automatic value lands in the valley between them.

  • Raise it to include lighter greys: faint pencil lines, thin strokes that break up, a signature written in light blue ink. Strokes get thicker.
  • Lower it to keep only the darkest pixels: drop a grey shadow or a paper tint, thin out lines that have bled together, open up blocked counters in small text.

Once you move the slider your value is kept until you load another image or restore the defaults; until then the value is recalculated automatically, for example after you change Blur. A full walkthrough with the histogram is in How to vectorize a scanned drawing.

Colour settings

Output

Default: Separate shapes.

Real output · 2 settings comparedSeparate shapes vs stacked layers
Separate shapes: 18 shapes, no overlap
Separate shapes18 shapes, no overlapRecommended
Stacked layers: 6 layers, overlapping
Stacked layers6 layers, overlapping
Both drawn at 55% opacity so overlaps show through. Separate shapes fit together like puzzle pieces with no overlap; stacked layers pile full colour silhouettes on top of each other.

Separate shapes makes every connected region of every colour its own <path>, as a true cut-out: a shape with something inside it has a real hole there, and neighbouring shapes share exactly the same boundary curve. Nothing overlaps and there are no hairline gaps, so you can move, recolour or delete any shape on its own. This is the right choice for cutting machines, for editing, and for most uses.

Stacked layers makes one path per colour, ordered dark to light, where each layer also covers the area of every lighter colour above it. Lighter layers paint over darker ones. You get very few paths (one per palette colour), which is handy when you want to recolour a whole colour in one click, but shapes overlap and the darkest layer covers every coloured pixel in the image.

Example: a red apple with a green leaf on white. Separate shapes gives you an apple, a leaf, a stalk and a white background, each independent. Stacked layers gives you a dark layer the size of the whole picture, with each lighter colour stacked on top.

Number of colours

Default: 8. Range: 2–32.

Real output · 3 settings comparedNumber of colours sets the level of detail
2 colours: 2 used · 6 shapes
2 colours2 used · 6 shapes
4 colours: 4 used · 13 shapes
4 colours4 used · 13 shapes
8 colours: 6 used · 17 shapes
8 colours6 used · 17 shapesRecommended
The illustration reduced to 2, 4 and 8 colours. Similar colours are merged, so the count is a maximum: this image only needs 6.

The maximum number of colours in the palette, including the background. The palette appears as swatches under the setting. If the image has fewer real colours, near-identical ones are merged and you get fewer.

  • Set it to the number of flat colours you can count, background included. A two-colour logo on white needs 3.
  • Raise it when two distinct colours are being merged into one.
  • Lower it when gradients or shading break into bands of extra shapes, or when the file is larger than you want. Fewer colours also trace faster.

Remove background

Default: off. Applies to Separate shapes output.

Real output · 2 settings comparedRemove background drops the backdrop
Remove background off: backdrop kept as a shape
Remove background offbackdrop kept as a shape
Remove background on: transparent background
Remove background ontransparent backgroundRecommended
A logo on a solid backdrop. With Remove background on, regions touching the image border are left out, so the SVG has a transparent background.

Finds the most common colour along the image border and drops every region of that colour that touches the border. The result is artwork floating on a transparent canvas, ready to place on any background or send to a cutter. Regions of the same colour that do not touch the border, such as the inside of a letter O, are kept. If the background was transparent in the original, it is already left empty and you do not need this option.

Tracing settings

These apply in both modes and control how the pixel outlines are turned into curves.

Ignore less than

Default: 2. Range: 0 upwards, in square pixels of the traced image.

Real output · 3 settings comparedIgnore less than removes dust and speckles
Ignore less than 0: 157 shapes
Ignore less than 0157 shapes
Ignore less than 2: 154 shapes
Ignore less than 2154 shapes
Ignore less than 40: 5 shapes
Ignore less than 405 shapesRecommended
Every dark speck becomes a shape unless it is smaller than this area (in square pixels). Raising it cleans up scans without touching the real drawing.

Outlines enclosing less area than this are discarded. In Black & white that removes both stray specks and tiny pinholes inside solid areas. In Colour, small regions are merged into their neighbouring colour, so no gap is left behind.

  • Raise it (10–50 or more) for scans with dust, JPEG noise, or textured backgrounds.
  • Lower it to 0 or 1 when real detail is tiny: the dots of a stipple drawing, pixel art at 1 px per pixel, full stops in small text.

The area is measured after Max size scaling, so the same value removes relatively larger specks on a smaller working image.

Smoothness

Default: 1. Range: 0 (polygonal) to 1.34 (very smooth).

Real output · 3 settings comparedSmoothness balances sharp corners and round curves
Smoothness 0: all corners
Smoothness 0all corners
Smoothness 1 (default): corners + curves
Smoothness 1 (default)corners + curvesRecommended
Smoothness 1.34: all curves
Smoothness 1.34all curves
Zoomed into the logo badge. At 0 everything is straight segments; at 1.34 even the mountain peaks are rounded off. The default keeps real corners sharp and curves smooth.

Smoothness decides, at every vertex of the outline, whether the turn is kept as a sharp corner or drawn as a curve. At 0 every vertex is a corner and the output is made of straight lines only. As the value rises, gentler turns become curves; at 1 only sharper turns stay corners. At 1.34 even right angles are rounded.

  • Lower it (0.5–0.8) for geometric logos, technical drawings and lettering with crisp joins.
  • Use 0 for pixel art or deliberately faceted, low-poly results.
  • Raise it (1.1–1.3) for organic artwork such as brush lettering, hand drawings and soft cartoon shapes.

Independently of this setting, corners between straight edges are kept exact and corners softened by anti-aliasing are rebuilt, so a square stays square at the default.

Curve optimisation

Default: 0.2. Range: 0 upwards; useful values are roughly 0–1.

Real output · 3 settings comparedCurve optimisation trades nodes for accuracy
Curve optimisation 0: 2001 nodes
Curve optimisation 02001 nodes
Curve optimisation 0.2: 1008 nodes
Curve optimisation 0.21008 nodesRecommended
Curve optimisation 1: 341 nodes
Curve optimisation 1341 nodes
Blue dots are the nodes in the SVG. Higher values merge more segments, giving lighter files that are easier to edit, at the cost of small deviations from the original.

This is the fitting tolerance: how far, in pixels, the simplified outline may stray from the traced pixel edge. Low values follow every bump and keep more nodes; high values let long smooth curves replace runs of short ones.

  • Lower it (0–0.1) when small details are being softened or fine text loses its shape.
  • Raise it (0.4–1) for a lighter file that is easier to edit, especially for large, simple shapes.

Watch small shapes when you raise it: a dot a few pixels wide can turn lumpy or polygonal, and corners can drift. The node count in the status line tells you how much you are saving.

Max size (px)

Default: 2048. Options: 1024, 2048, 4096, Full resolution.

Before tracing, the image is scaled down so its longest side is no larger than this. The status line shows the working size next to the source size. Changing the value reloads the image at the new size.

  • Lower it to 1024 for faster previews of large photos or scans, or to smooth out noise.
  • Raise it to 4096 or Full resolution for very large artwork with fine detail, such as a poster-sized scan with thin hairlines.

Images are never scaled up: a 600 px image is traced at 600 px whatever you choose. Full resolution is capped at about 36 megapixels to keep the browser from running out of memory.

Preview and status line

The Mode menu in the Preview group switches what the main view shows:

  • Original image: your source, as loaded.
  • Processed image: the black and white mask after Invert, Blur and Threshold. This is exactly what gets traced in Black & white mode. In Colour mode it shows the original.
  • Traced vector (default): the SVG result.

Three switches add overlays to the traced view. They only affect the preview, never the downloaded file.

  • Show path (on by default) draws a thin red outline around every shape, so you can see where one ends and the next begins.
  • Show points (on by default) marks every node with a blue dot. Clusters of dots show where the trace is working hard; long stretches with few dots are clean curves. On very complex traces only a sample of the dots is drawn.
  • Fade image shows the original faded underneath the vector, so you can check the outline sits on the artwork.

The status line under the preview reports the working size and source size, the trace time, the SVG size in KB, the number of shapes (or layers, for Stacked output) and the number of nodes. Use it to compare settings: if raising Curve optimisation from 0.2 to 0.5 halves the nodes and the shapes still look right, keep it.

Exporting: Download SVG and Copy SVG

Download SVG saves the trace as a file named after your image, with an .svg extension. Copy SVG puts the full SVG markup on the clipboard, ready to paste into a code editor, an HTML page, Figma or another design tool.

Some browsers block clipboard access on pages that are not served over HTTPS. If that happens the status line says so; use Download SVG instead.

What you export is exactly what the Traced vector view shows, without the path and point overlays.

What the SVG file contains

The output is plain, hand-readable SVG with no editor metadata, scripts, embedded images or groups.

  • One root <svg> whose width, height and viewBox equal the traced pixel size. A trace at 1024×512 px is 1024×512 units. Being a vector, it scales to any size without losing sharpness.
  • A list of <path> elements, each with a solid fill colour (black in Black & white mode) and fill-rule="evenodd".
  • Outlines made of straight lines and quadratic Bézier curves, written with relative commands and coordinates rounded to a hundredth of a pixel to keep the file compact.
  • In Black & white mode, and in Colour mode with Separate shapes output, every visually separate shape is its own path together with its own holes. The letter A is one path containing its outer outline and its triangular hole, so selecting it in a vector editor selects the whole letter and nothing else.
  • No strokes, gradients, filters or masks: every shape is a filled area.

Because holes are real holes rather than white shapes on top, the SVG works on any background and is accepted by cutting and laser software that expects closed filled paths.

Privacy and offline use

Image Tracer runs 100% in your browser. Your image is decoded and traced on your own device, in a Web Worker so the page stays responsive, and it is never uploaded to a server. There is no account and no cloud history; when you close the tab, the image is gone.

Once the page has loaded it keeps working without an internet connection. That makes it suitable for confidential material such as signatures, unreleased logos or client artwork. The code is open source on GitHub, so you can check this for yourself.

Shortcuts and ways to load an image

ActionHow
Paste an image from the clipboardCtrl+V (Windows, Linux) or Cmd+V (Mac), anywhere on the page
Open a fileDrag and drop it onto the page, click Open image, or click the drop zone (Enter or Space when it has keyboard focus)
Remove the current imageEsc, or the Remove image button above the preview. Your settings are kept.
Reset every settingRestore default settings at the bottom of the panel

Esc does nothing while you are typing in a settings field, so you cannot clear the image by accident. Pasting works with screenshots and with images copied from most apps and web pages.

Troubleshooting

The result is a black block with my artwork cut out

The tracer is treating the background as ink. Turn on Invert image if your artwork is light on dark, or lower the Threshold if the background is a mid grey.

Thin lines are broken or missing

Raise the Threshold so lighter strokes count as ink, set Blur back to 0, and try a larger Max size if the source is big. Lower Ignore less than if fragments of the line are being discarded.

The trace is covered in specks

Raise Ignore less than to 10–50, add a Blur of 1–2, or lower the Threshold so paper texture falls on the background side.

Edges look wobbly or lumpy

The source is probably small or compressed. Use the largest original you have, add a little Blur, and lower Curve optimisation if small curves are being flattened. Note that the vector cannot invent detail the pixels do not contain.

Corners are rounded

Lower Smoothness to 0.6–0.8. Make sure Blur is 0, since blur rounds corners before tracing.

The file is too large or has too many nodes

Raise Curve optimisation, raise Ignore less than, reduce the Number of colours, or lower Max size. Photos and gradients produce heavy files whatever you do.

Colour mode adds bands or extra shapes

Gradients, shadows and JPEG noise are being split into palette steps. Lower the Number of colours to the count of flat colours you actually want.

The image will not load

Use PNG, JPEG, WebP, GIF or BMP. Formats your browser cannot decode, and SVG files, are rejected with a message in the status line. Re-export the image as PNG and try again.

What Image Tracer does not do

Being clear about limits saves time. Image Tracer does not:

  • Produce centerline or stroke output. Every line is traced as a filled outline with two edges, not as a single stroke you can change the width of.
  • Use AI or upscale. It traces the pixels you give it. Blurry or tiny sources give soft or approximate results.
  • Create gradients. Colour output uses flat fills only, so photographs become posterised regions.
  • Export PDF, EPS or DXF. The output is SVG; convert it in a vector editor if you need another format.
  • Batch process. One image at a time.
  • Edit nodes. There are no drawing tools; open the SVG in Inkscape, Illustrator, Affinity Designer or Figma for clean-up.
  • Accept SVG input, keep a history, sync to a cloud account, or come as a mobile app.

The engine is inspired by Potrace but is not Potrace, so node counts and curve placement differ from tools built on it. See Image Tracer vs Potrace for details.

Frequently asked questions

What are the best default settings to start with?

The defaults: Black & white mode, automatic threshold, Blur 0, Ignore less than 2, Smoothness 1, Curve optimisation 0.2, Max size 2048. They give a faithful trace of clean artwork. Change one setting at a time from there; Best settings for image tracing has recipes per image type.

Why is my SVG the same pixel size as my image?

The SVG's width, height and viewBox match the size the image was traced at, so it lines up with the original. It is still a vector: set any width and height in your editor or CSS and it stays sharp.

Does Image Tracer upload my images?

No. Decoding and tracing happen in your browser on your own device, and nothing is sent to a server. Once the page has loaded it works offline.

How do I get a transparent background in colour mode?

Turn on Remove background with Separate shapes output. It drops the background colour regions that touch the image border. Areas that were already transparent in a PNG are left empty automatically.

Can I get single-line strokes instead of filled shapes?

No. Image Tracer always produces filled outlines. For plotters or engraving that need single strokes, use a dedicated centerline tool.

Why does the node count matter?

Fewer nodes means a smaller file, faster rendering and much easier editing. Aim for the lowest count that still matches the artwork when zoomed in, using Curve optimisation and Ignore less than.

Last updated

Your sharpest image is one drop away

Open Image Tracer, drop in a file and download a clean SVG in about ten seconds.

Convert your image for free
  • No account required
  • No watermark