Document photos are a tiny image-processing problem with sharp edges

Abdullah Khan — Thu, 28 May 2026 01:06:15 +0000

Disclosure: I work on Passlens, a browser-first passport and ID photo maker. This post is about the product decisions behind that workflow, not a neutral review of every tool in the space.

A passport photo looks simple until you try to make one that an upload form will actually accept. It is a headshot, yes, but it is also a small chain of constraints: physical size, pixel size, background, head position, print scale, and whatever the destination country's portal decides to reject that week.

That is why generic photo editors feel slightly wrong for this job. They can crop. They can resize. They can export. The hard part is not any one of those actions. The hard part is keeping all of them tied to the document rule the user picked.

The unit problem

For developers, document photos are awkward because two units matter at the same time.

A user may need a 2x2 inch passport photo. A visa portal may ask for 600x600 pixels. A print sheet may need 35x45 mm photos at 300 DPI. These are not the same request, but people often treat them as if they are.

If the app only thinks in pixels, the print can come out the wrong physical size. If it only thinks in millimetres or inches, the digital upload can be rejected for the wrong pixel dimensions. A good workflow has to keep both ideas alive: the document size and the export target.

That is the main reason Passlens keeps presets and print layouts as first-class pieces of the workflow instead of treating them as labels on a crop box.

The crop is not the output

Another small trap: the crop the user sees is not always the final output.

For a digital upload, the crop usually becomes one image file. For printing, the same crop may become several photos arranged on 4x6, A4, or Letter paper with spacing, margins, and optional cut marks. If that print sheet is scaled by the browser or printer dialog, the whole thing is wrong.

So the editor needs to separate three things:

the face and shoulder crop
the finished document-photo size
the print sheet or digital export format

That separation is less glamorous than a big feature list, but it is what makes the final file usable.

Local by default matters here

Passport and ID photos are personal. They are not abstract test images.

For that reason, the basic Passlens flow runs in the browser by default. Users can pick a preset, line up the crop, adjust the background, and export without creating an account. Heavier background cleanup is optional, and it is described as a separate choice instead of being hidden behind the button.

That does not make the product perfect. Document rules still vary, and official guidance sometimes leaves gaps. But the workflow should make the tradeoff visible: keep routine editing local when possible, and only use server processing when the user chooses it.

Why this became a product

The first version of this kind of tool is easy to underestimate. You build a cropper, add an export button, and think you are close. Then the real edge cases show up:

a user needs 35x45 mm but the printer wants a 4x6 inch sheet
another user has a 600x600 upload requirement and no idea what DPI means
someone prints from a browser dialog that scales the PDF to fit
a background color rule is stricter than the person expected
a travel document has a size that does not match the common passport presets

That is the product surface. Not a fancy filter. Not a photo gallery. Just a pile of boring constraints that need to stay boring for the user.

If you want to try the workflow, the free editor is here: Passlens passport photo maker.

I also keep coming back to a few practical pages when thinking about the UX:

The lesson for me is simple: small image tools are only simple when the output does not matter. The moment a government form, a print shop, or a visa appointment depends on the file, the boring details become the product.

DEV Community: Abdullah Khan

Document photos are a tiny image-processing problem with sharp edges

The unit problem

The crop is not the output

Local by default matters here

Why this became a product