Frappe and ERPNext changes, 20 Jul to 26 Jul 2026

Breaking changes

Read these before you update. They can change how your site or app works.

• breaking Accept list payload for trans_items in update_child_qty_rate Frappe's type validation was rejecting legitimate JSON list payloads from clients, breaking the API despite the payload being valid.
• breaking Remove invalid doc.guardian reference breaking guardian search functionality Guardian search was filtering with a nonexistent field, blocking users from linking Guardians to Students via the Relations tab.
• breaking Remove conflict markers from frappe version requirement Backport merge left unresolved conflict markers in `pyproject.toml`, breaking TOML parsing and making bench unable to read the dependency.
• breaking Accept dict target_doc in mapper endpoints With native JSON request bodies, `map_docs` forwards `target_doc` as a dict, breaking all "Get Items From" buttons; now accepts dict/str/Document.
• breaking Create default warehouses with untranslated names Warehouse names were translated at creation, breaking opening-stock fallback lookups from sessions in different languages.
• breaking Read serial and batch flags from Item in Stock Balance's SLE query Stock Balance query was missing `has_batch_no` and reading `has_serial_no` from wrong column, breaking batch/serial consumption matching.

Frappe 9 new features · 8 speed-ups · 47 fixes · 7 refactors

• feat Silent autosave status and lighter builder chrome Print builder autosave is now silent when saved, shows brief "Saving…" only during requests, and sticky red "Save failed" on error; drops "Reset Changes" and one-item section headers.
• feat Open builder preview in a modal instead of a dock Print preview now opens as a centered modal over the builder instead of a docked rail; gives preview full width and matches on-demand UX.
• feat Full screen toggle for the builder preview Print builder preview can now toggle full-screen; same iframe grows to viewport with Esc or shrink button to restore dock.
• feat Add guard hooks to open_mapped_doc Adds sanctioned extension point with `add_mapped_doc_guard()` and `should_open_mapped_doc()` to intercept before opening mapped documents.
• feat Add print option in form menu on mobile Print action now appears in form menu on mobile devices for easier access.

ERPNext 4 breaking · 5 new features · 4 speed-ups · 27 fixes · 6 refactors

• breaking Accept list payload for trans_items in update_child_qty_rate Frappe's type validation was rejecting legitimate JSON list payloads from clients, breaking the API despite the payload being valid.
• breaking Accept dict target_doc in mapper endpoints With native JSON request bodies, `map_docs` forwards `target_doc` as a dict, breaking all "Get Items From" buttons; now accepts dict/str/Document.
• breaking Create default warehouses with untranslated names Warehouse names were translated at creation, breaking opening-stock fallback lookups from sessions in different languages.
• breaking Read serial and batch flags from Item in Stock Balance's SLE query Stock Balance query was missing `has_batch_no` and reading `has_serial_no` from wrong column, breaking batch/serial consumption matching.
• feat Block sales invoice submit when customer overdue exceeds threshold Backport of credit limit enforcement: blocks Sales Invoice submit when a customer's overdue amount exceeds configured limit unless the user holds a bypass role.

HR 2 new features · 6 fixes · 3 refactors

• feat Add Contract link in Employee Connections section Contract doctype now appears in Employee connections dashboard.
• feat Filter system users in department approver tables Department approver fields now filter to show only System Users, preventing Website Users from being selected.
• fix Correct salary slip naming when created via data import Data Import was generating wrong salary slip names (e.g., `Sal Slip/None/00001`) because default_series read unset employee field; now lazily evaluated.
• fix Exclude disabled users from approver list Disabled users no longer appear in leave, expense, and shift approval searches.
• fix Skip expire_allocation for already-cancelled Leave Allocations Leave expiry no longer processes cancelled allocations.

CRM 1 speed-ups · 5 fixes · 1 refactors

• perf Migrate Editor to CommentBox and EmailEditor component ref: migrate Editor to CommentBox and EmailEditor component
• fix Breadcrumb preserve query params, PrimaryDropdown Layout, box shadow in email activity card fix: breadcrumb preserve query params, PrimaryDropdown Layout, box shadow in email activity card
• fix Load a single prosemirror-model in production builds Production builds were loading multiple instances of prosemirror-model; now unified.
• fix Upgrade frappe-ui to beta.24 and resolve UI regressions Button icon handling, list controls, text inputs, and settings pages fixed after frappe-ui upgrade.
• fix Lead/deal report 500s when a child-table column is selected Permission conditions now properly qualify column names to avoid ambiguity when child tables join.

LMS 1 new features · 1 fixes · 1 refactors

• feat Raven membership integration Raven integration for LMS: registers rule types (All Enrolled Students, Students of Courses/Batches, Staff), evaluator, and Raven sidebar panel.
• fix Inline pdf.js PDF viewer for iOS Safari + macro fixes PDFs now render via pdfjs-dist to `<canvas>` instead of ``, enabling scroll on iOS; adds continuous scroll, zoom, pinch-zoom, and error states.</canvas>
• refactor Merge 'main-hotfix' into 'main' chore: merge 'main-hotfix' into 'main'

• feat Inform users when the site is in read-only mode Builder now shows a message when the site enters read-only maintenance mode instead of silently failing saves.
• feat Invite users to Builder Site members can now be invited to Builder by email without going through Desk; invitees get Website Manager role on accepting.
• feat Align border control with spacing split-mode inputs Border control now supports split-mode inputs (top/right/bottom/left) matching spacing and border radius layout.
• feat Load real italic faces through the ital axis Google Fonts loader now requests italic axis alongside weight, so italic text renders with real italic faces instead of browser-synthesised slant.
• perf Trim editor bundle and fix text editor memory leak Lazy-loads Google Fonts catalog, CodeMirror, and page script panel; fixes text editor memory leak in long editing sessions.

Helpdesk 3 new features · 3 fixes · 1 refactors

• feat Recent Activity card on Home dashboard Agents now see a Recent Activity card on home showing recently-acted tickets with action types (Replied, Commented, etc) and clickable rows.
• feat Rtl support RTL support backport with physical-to-logical Tailwind utilities and directional icon rotations.
• feat Display ticket priority as icon and level Replaces arbitrary `integer_value` on HD Ticket Priority with purposeful `level` field (Urgent/High/Medium/Low) and renders as icon + name.
• fix Attachment upload feedback + uploads while editing comments File uploads now show visual feedback with a spinner and disable the send button; uploading while editing comments now works.
• fix Set default portal settings for existing sites Fresh Helpdesk installs set `default_role` and `default_portal_home` but existing sites never received them; now applies via a patch.

Insights 1 fixes · 1 refactors

• fix Respect Week Starts On in timespan filters Week filter boundaries now use Insights Settings week_starts_on instead of System Settings, ensuring consistent week grouping.
• refactor Add frappe dependency for bench Add frappe dependency for bench

• breaking Remove conflict markers from frappe version requirement Backport merge left unresolved conflict markers in `pyproject.toml`, breaking TOML parsing and making bench unable to read the dependency.
• feat Add incident time and confirm noisy neighbours Investigation now accepts optional `incident_time` for a centered 12-hour window (instead of trailing 24 hours), and confirms noisy neighbor detection.
• feat Allow more actions on inactive sites Inactive sites now support reinstall, restore, migrate, and update operations; update_without_backup now matches schedule_update allowed states.
• feat Add playbook to update ProxySQL on proxies Playbook added to upgrade ProxySQL from 2.3.2 to 3.0.9 across all proxies with atomic backup and rollback.
• fix Set team from site instead of session user Offsite backup restores were failing because backup remote files were assigned to the wrong team (Administrator's) instead of the site's team.

• breaking Remove invalid doc.guardian reference breaking guardian search functionality Guardian search was filtering with a nonexistent field, blocking users from linking Guardians to Students via the Relations tab.
• feat Integrated Code Editor [Experimental] Built with Monaco editor and frappe-ui; allows editing code directly in Pilot.
• feat Upgrade to frappe-ui v1 Upgraded Frappe Wiki to frappe-ui v1 (beta.25), migrated v1 component APIs, rebuilt editor chrome on frappe-ui atoms, and bumped tiptap to v3.
• feat Google Sheets keyboard shortcuts + fix whole-line select anchor Adds Shift+Space / Ctrl+Space / Ctrl+Shift+Space for row / column / whole-sheet select, Ctrl+Alt+=/- for insert/delete, and Ctrl+Shift+1…5 for format shortcuts; fixes Shift+Space anchor jumping.
• feat Homepage list view — header sort, toolbar search, full-width scroll Sheets homepage list now sorts from column headers (click to sort, click again to flip), toolbar search, and full-width scrolling; replaces separate "Sort by" dropdown.