# Mealie v3.25.0

- Product: Mealie (https://whatsnew.fyi/product/mealie)
- Vendor: Mealie
- Date: 2026-09-02
- Version: v3.25.0
- Original notes: https://github.com/mealie-recipes/mealie/releases/tag/v3.25.0
- Permalink: https://whatsnew.fyi/product/mealie/releases/v3.25.0

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **changed** — Tokens now refresh automatically before they expire, keeping users logged in during active sessions
- **changed** — SESSION_TIMEOUT behavior changed so that closing your tab/browser/session logs you out, requiring Remember Me to stay logged in between sessions
- **changed** — Remember Me is now checked by default on login
- **changed** — TOKEN_TIME now defines session duration instead of arbitrary expiration; recommend lowering to at most 168 hours
- **removed** — GET /api/auth/refresh endpoint removed and replaced with POST /api/auth/refresh
- **added** — Delete unused organizers from the data management page
- **added** — Leverage recipe rating in meal plan rules, cookbooks, and recipe finder
- **added** — Click on recipe image or asset to show fully expanded image in lightbox
- **added** — Improve registration UX by coloring Next button based on form validity
- **added** — Autofocus RecipeSelector input field
- **changed** — Meal Planner UI reworked for easier use
- **changed** — Shopping list focus polishes
- **changed** — Improve recipe parsing UI
- **changed** — Rank exact and prefix matches above substring matches in food search
- **fixed** — Fallback to regular HTML if video download fails
- **fixed** — Improve keyboard navigation of search results
- **fixed** — Allow deleting a user who both rated and favorited a recipe
- **fixed** — Account for on-hand items when adding a recipe to a shopping list
- **fixed** — Parse day- and week-only ISO 8601 durations in recipe time cleaner
- **fixed** — Strip trailing footnote markers from parsed ingredient names
- **fixed** — Preserve source language in AI recipe parsing

#### 🍴🍴🍴🍴🍴🍴

This release comes with an overhaul to Mealie's internal auth, making it more inline with what you generally expect, specifically with "Remember Me" and `TOKEN_TIME`.

- Tokens now refresh automatically before they expire. As long as you use the app before your token expires, it will automatically be refreshed with a new token. What this means for users is that you won't be logged-out mid-session, and you shouldn't have to log-in periodically unless you haven't used the app in some time (see `TOKEN_TIME` changes).
- Once you close your tab/browser/session, you will be logged-out. To stay logged-in between sessions, check "Remember Me" when logging in. Since this is the _opposite_ behavior of how logins worked before this change, "Remember Me" is checked by default to help ease the learning curve.
- `TOKEN_TIME` now defines how long a session will last before expiring. Many instances previously set this value arbitrarily high to prevent users from being logged-out. Now with auto-refresh this is unnecessary, and can be substantially lowered (we recommend turning this down to at most 168 hours, i.e. one week).

###### ⚠️⚠️⚠️ IMPORTANT BREAKING CHANGE FOR APP DEVELOPERS ⚠️⚠️⚠️
`GET /api/auth/refresh` has been removed, and is instead now a `POST` API.

##### 🎉 Highlights

- Overhauled internal auth (see above)
- You can now delete unused organizers from the data management page
- You can now leverage a recipe's rating in meal plan rules, cookbooks, and the recipe finder
- Clicking on a recipe's image or asset will show the the fully expanded image
- The Meal Planner UI has been reworked to make it easier to use

##### 🚨 Breaking changes

- feat: add token refresh, fix remember me, and fix Safari token expiration @michael-genson (#8200)

##### ✨ New features

- feat: add token refresh, fix remember me, and fix Safari token expiration @michael-genson (#8200)
- feat: organizer improvements — recipeCount, merge endpoint, delete unused UI @bferd (#7829)
- feat: Shopping list focus polishes @miah120 (#7890)
- feat: add rating as a query filter field @dominikrein (#7966)
- feat: click-to-expand lightbox for recipe hero image and asset images @bferd (#7933)
- feat: improve registration UX by coloring Next button based on form validity @Luna-81 (#8233)
- feat: Improve recipe parsing ui @miah120 (#7984)
- feat: rank exact and prefix matches above substring matches in food search @dyllan500 (#7781)
- feat: Meal Planner UI Improvements @miah120 (#7946)
- feat: add autofocus to RecipeSelector input field @torbenvanassche (#8262)

##### 🐛 Bug fixes

- fix: fallback to regular HTML if video download fails @michael-genson (#8203)
- fix: Improve keyboard navigation of search results @mbianucci (#7869)
- fix: allow deleting a user who both rated and favorited a recipe (#8121) @chiliec (#8131)
- fix: wrap timeline event subjects @YibingZhang325 (#8218)
- fix: Account for on hand items when adding a recipe to a shopping list @miah120 (#7912)
- fix: close long-lived token auth transaction @stieglma (#7897)
- fix: stamp timeline events at request time, not process start @alexander-wenzel-dev (#7896)
- fix: repoint shopping list items when merging a food or unit @henry1113nz (#8146)
- fix: parse day- and week-only ISO 8601 durations in recipe time cleaner @TowyTowy (#7895)
- fix: strip trailing footnote markers from parsed ingredient names @henry1113nz (#8145)
- fix: hide "No Label" heading when copying an unlabeled shopping list @brent20 (#7905)
- fix: Add bottom padding to prevent fab overlapping content @miah120 (#7940)
- fix: resize images before AI import to avoid provider size limits @chiliec (#8241)
- fix: Keep instruction sticky in ingredient linker @miah120 (#7925)
- fix: skip image request when a recipe has no image @henry1113nz (#8075)
- fix: preserve source language in AI recipe parsing @x0x0b (#8236)
- fix: refetch organizer data pages on visit to avoid stale data @l

_[Truncated at 4000 characters — full notes: https://github.com/mealie-recipes/mealie/releases/tag/v3.25.0]_