Plugging to Phoenix endpoint results in `malformes-url` error

[sntran]

Per documentation, when I add plug Image.Plug to my Phoenix endpoint.ex, it intercepts all requests at / and fail the pipeline with

GET /
image_plug request failed: tag=malformed_url
Plug.Conn.AlreadySentError

I'm using Image.Plug.Provider.Cloudglafe.

To get around that, I have to add my own plug to forward only requests matching /cdn-cgi/image to Image_Plug, but I should not have to do that.

[kipcole9]

Thanks very much for the issue and sorry for the slow response - I've been out of communications range for a few days.

I've now published image_plug version 0.2.0 to resolve this issue. There is also a new documentation section on how to configure image_plug as part of a broader Phoenix routers.

The changelog entry is:

[v0.2.0] — 2026-07-22

Changed

• Requires image ~> 0.72 and adopts its unified :background option (replacing the removed :background_color) in the background, border and pad pipeline operations.

Fixed

• Image.Plug now passes through requests whose URL the provider does not recognise as an image request, returning the connection untouched and un-halted so the host application's remaining plugs handle it. This applies uniformly across all bundled providers (Cloudflare, imgix, Cloudinary, ImageKit and IIIF): a request only errors when its URL names the provider's image grammar but is malformed. Previously every non-image URL produced an error response, so mounting plug Image.Plug ahead of a Phoenix router intercepted all routes. Thanks to @sntran for the report. Closes Plugging to Phoenix endpoint results in malformes-url error #2.

• Image.Plug now halts the connection after sending a response. Previously a served or errored request left the connection un-halted, so a following plug in an endpoint pipeline sent again and raised Plug.Conn.AlreadySentError.

Documentation

• Documents how to mount Image.Plug inside a larger Phoenix router, explaining passthrough routing and the role of the provider :mount prefix. See the usage guide.