toolkit

In Action · Something looks broken

The gallery photos aren't showing

“The gallery photos aren't showing.” Or: “Half the before-and-after cases look wrong.”

A before-and-after gallery is often a practice's most-visited page after the home page, and it fails in a way a normal scroll-through misses entirely: one broken thumbnail, one orphaned photo with no matching pair, buried in a grid of dozens where nothing looks obviously wrong. This checks every image in the gallery and flags exactly which ones never loaded and which pairs are only half-uploaded, so the fix targets the actual broken cases instead of a guess.

What to ask for

Gallery & before/after auditGallery and before/after auditor — renders a gallery page and grades what is actually wrong with it: images that do not load, distorted or excessively cropped gallery cards, before/after cases with a missing partner, gallery images with no alt text, and originals served far larger than they display.

See it work

A real run of Gallery & before/after audit:

FAIL
      8 image(s) · 3 pair(s) · 0 composite case(s) · 2 unpaired
      [error] 1 gallery image(s) are broken — missing-case.jpg
      [warn] 2 before/after image(s) have no partner — a half-uploaded case looks complete to whoever added it: before "missing-case.jpg" · after "yH5BAEAAAAALAAAAAABAAEAAAIBRAA7"

  report: ./out/gallery-and-before-after-audit-gallery-and-before-after-audit.html
  text:   ./out/gallery-and-before-after-audit-gallery-and-before-after-audit.txt

The captured report, exactly as a run hands it to a client —open the full report ↗

A before/after gallery is frequently a practice’s most-visited page after the homepage, and it fails in a way a casual glance misses: a broken thumbnail here, an orphaned “before” with no matching “after” there, in a grid of dozens where nothing looks obviously wrong from a normal scroll-through.

  1. Run the gallery check against the affected public page.
  2. Read the report to separate two different problems: images that never loaded at all, and before/after pairs that are only half-uploaded. They need different fixes.
  3. [manual] Hand the specific failing URLs to the page or media owner — pairing is a judgement call the check makes conservatively on purpose (it only pairs when filenames or alt text differ by exactly the before/after token), so a case it can’t confidently pair is left for a person, not guessed at.
  4. Verify the public page after the repair and rerun the check to confirm every expected image actually paints — not just that the upload succeeded.

A missing case is a lost patient story

A gallery with three hundred images and twelve broken ones looks fine to anyone scrolling past it. It does not look fine to the patient looking for their own case, or to whoever it was meant to reassure — which is exactly why this gets a dedicated check rather than a casual look.

What this does not cover

Whether the photo is the *right* photo. It reports which images failed to paint and which before/after pairs are half-done; judging whether a case belongs on the page — or whether it has the patient's consent to be there — is a human call the check never makes.

← All jobs