Skip to content

Open-tracking pixel shows as a broken-image icon in the Gmail iOS app (padded PNG); a 1×1 GIF fixes it #658

Open

Description

@marcosrondina

Version: v44.0, self-hosted (Docker), Amazon SES integration, open tracking enabled at workspace level.

Problem

In the Gmail iOS app, every tracked email shows a broken-image icon (a small box with "?") at the bottom of the message, where the injected open-tracking pixel sits. Gmail on desktop and Outlook show nothing.

The open itself is recorded: an access log on our reverse proxy shows GoogleImageProxy requesting /t/<token> at the moment the message is opened on the phone and receiving 200, image/png, 825 bytes, and opened_at is set at the same second.

Cause (confirmed by test)

It is the image format served by the pixel endpoint — the padded 1×1 RGBA PNG (825 bytes, with several tEXt chunks; all CRCs valid) — combined with the dimensionless <img>.

We kept Notifuse untouched and made our reverse proxy (Caddy) forward /t/* to Notifuse as usual, but replace any 200 response body with a standard 42-byte 1×1 transparent GIF (image/gif). Result in the same Gmail iOS app:

  • broken-image icon gone
  • open still recorded (Notifuse handled the request)
  • click tracking unaffected (redirects are passed through)

Other things we tried that did not help:

  • CSS forcing the injected image to 1×1 (Gmail ignores the needed selectors and the injected markup has no class)
  • a template-level pixel using {{ tracking_opens_url }} with width="1" height="1": no icon from that one, but with opens disabled in the workspace nothing is recorded, and with opens enabled the injected pixel is added anyway

Suggestion

Serve a minimal 1×1 GIF (or an unpadded PNG) from the open-tracking endpoint, or make the format configurable. If the padding is there to evade pixel blockers, an option to choose would let operators trade that off against the Gmail iOS artifact.

Caddy workaround, for anyone hitting this:

handle /t/* {
	reverse_proxy 127.0.0.1:8081 {
		@ok status 200
		handle_response @ok {
			root * /srv/static/pixel
			rewrite * /px.gif
			header Cache-Control "no-cache, no-store, must-revalidate"
			file_server
		}
	}
}

Activity

  1. self-assigned this
    on Nov 22, 2026
  2. pierre-b commented on Nov 22, 2026

    @pierre-b
    Contributor

    Hi @marcosrondina , thanks for the report, I'm checking it right now!

  3. pierre-b commented on Nov 22, 2026

    @pierre-b
    Contributor

    Found the bug! Will ship a fix in the upcoming release!

  4. marcosrondina commented on Nov 22, 2026

    @marcosrondina
    Author

    Great!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions