[GH-ISSUE #156] Feature Request: Pass search query parameters from the main URL #105

New issue

Closed

opened 2026-03-15 12:34:09 +03:00 by kerem · 4 comments

kerem commented

2026-03-15 12:34:09 +03:00

Owner

Originally created by @bcremer on GitHub (Aug 29, 2023).
Original GitHub issue: https://github.com/axllent/mailpit/issues/156

Feature Request

Allow query parameters from the api/v1/search to be passed via the main Browser URL like so:
https://mailpit.local/?query=from:ticket-34745@project.local&limit=5

Use case

We running a shared mailpit instance for a large number of testsystems that all create mails in the mailpit instance using different from addresses.

We want to add a direct link in the ticket system to the mailpit instance filtered to a from address that matches the ticket.

Originally created by @bcremer on GitHub (Aug 29, 2023). Original GitHub issue: https://github.com/axllent/mailpit/issues/156 # Feature Request Allow query parameters from the `api/v1/search` to be passed via the main Browser URL like so: https://mailpit.local/?query=from:ticket-34745@project.local&limit=5 ## Use case We running a shared mailpit instance for a large number of testsystems that all create mails in the mailpit instance using different `from` addresses. We want to add a direct link in the ticket system to the mailpit instance filtered to a from address that matches the ticket.

kerem

2026-03-15 12:34:09 +03:00

closed this issue
added the
enhancement
label

kerem commented

2026-03-15 12:34:25 +03:00

Author

Owner

@axllent commented on GitHub (Aug 30, 2023):

Hi @bcremer, thanks for the feedback. Currently this is not possible as it would require the ability to parse URL parameters on the frontend which Mailpit does not have. In order to achieve this, the Vue frontend would need to to use URL routing which would mean a rather large rewrite of several core UI components as it would also impact every other aspect of the UI too (filtering , pagination, messages, etc).

This feature is however already "planned", or rather I have been strongly considering this for future changes. I just don't know when that will happen as it requires a fair amount of time to write / adapt. I will leave this open as a reminder :)

@axllent commented on GitHub (Aug 30, 2023): Hi @bcremer, thanks for the feedback. Currently this is not possible as it would require the ability to parse URL parameters on the frontend which Mailpit does not have. In order to achieve this, the Vue frontend would need to to use URL routing which would mean a rather large rewrite of several core UI components as it would also impact every other aspect of the UI too (filtering , pagination, messages, etc). This feature is however already "planned", or rather I have been strongly considering this for future changes. I just don't know when that will happen as it requires a fair amount of time to write / adapt. I will leave this open as a reminder :)

kerem commented

2026-03-15 12:34:30 +03:00

Author

Owner

@axllent commented on GitHub (Sep 22, 2023):

I have just released v1.9.0 which includes virtual routing. You cannot however set the pagination limit, but you can link directly to searches, eg: https://mailpit.local/search?q=from:ticket-34745@project.local

@axllent commented on GitHub (Sep 22, 2023): I have just released [v1.9.0](https://github.com/axllent/mailpit/releases/tag/v1.9.0) which includes virtual routing. You cannot however set the pagination limit, but you can link directly to searches, eg: `https://mailpit.local/search?q=from:ticket-34745@project.local`

kerem commented

2026-03-15 12:34:36 +03:00

Author

Owner

@axllent commented on GitHub (Sep 27, 2023):

I'm closing this as complete, but feel free to reopen if you have issues.

@axllent commented on GitHub (Sep 27, 2023): I'm closing this as complete, but feel free to reopen if you have issues.

kerem commented

2026-03-15 12:34:41 +03:00

Author

Owner

@bcremer commented on GitHub (Sep 27, 2023):

Works like a charm. Thank you.

@bcremer commented on GitHub (Sep 27, 2023): Works like a charm. Thank you.