Release Notes

A complete release history for Ionic Framework is available on GitHub. Documentation for recent releases can also be found below.

See versioning for information about our policy and commitment to stability.

8.5.1

patchLatest Production Version

March 19 2025

Bug Fixes

• modal: consider scrollable content while dragging when expandToScroll is false (#30257) (68be8e9)
• vue: update output target and fix incorrect types (#30259) (f4186c6), closes #30254

Performance Improvements

• modal: fixing performance regression on modal sheets when expandToScroll is false (#30267) (c4b9212)

8.5.0

minor

March 13 2025

Bug Fixes

• input: update helper text and counter color (#30149) (fdd5283)
• textarea: update helper text and counter color (#30148) (4322935)

Features

• checkbox: add helperText and errorText properties (#30140) (99d2f1c), closes #29810
• checkbox: add required prop (#30157) (41da4c3)
• config: add logLevel option to suppress ionic warnings and errors (#30015) (efd3e0f), closes #29814
• input, textarea: dir is inherited to native form control (#30102) (504fb6a), closes #30193 #29577
• modal: add expandToScroll property to allow scrolling at all breakpoints (#30097) (166e435), closes #24631
• radio-group: add helperText and errorText properties (#30222) (18e26ac)
• react: fixing support for react 19, adding test app for react 19 (#30217) (f4941f2), closes #29991
• select: add helperText and errorText properties (#30143) (bbdaec0), closes #29205
• select: add required prop (#30155) (0b54983)
• toggle: add helperText and errorText properties (#30161) (94ca2e5)
• toggle: add required prop (#30156) (0bbb9f3)
• toolbar: add shadow parts for background, container, and content (#30069) (ac4ea32), closes #30068

8.4.6

patch

March 19 2025

Bug Fixes

• vue: update output target and fix incorrect types (#30259) (0eaee78), closes #30254

8.4.5

patch

March 13 2025

Bug Fixes

• vue: pin Vue output target to latest release (#30248) (3799d45), closes #30221

8.4.4

patch

March 13 2025

Bug Fixes

• alert: change focused element and improve keyboard navigation (#30220) (4df0e0f)
• capacitor: replace deprecated platform check method (#30195) (b6b43ae)
• capacitor: use proper types for capacitor v7 support (#30228) (2149ba2)
• range: handle unsupported values for range min and max (#30070) (3223193), closes #29667
• segment-button: protect connectedCallback for when segment-content has not yet been created (#30138) (14b6538)
• select: auto-scroll to selected item for all interfaces (#30202) (8eaeb22), closes #19296
• toggle: trigger focus and blur on click (#30234) (ba8d8f4)
• vue: update output target and properly emit events (#30227) (11554a5), closes #30206 #30178 #30177 #30170
• vue: update output target and resolve type issues (#30239) (6dcb143), closes #30179

8.4.3

patch

January 29 2025

Bug Fixes

• vue: update Stencil Vue output target (#30159) (eb725fc)

8.4.2

patch

January 22 2025

Bug Fixes

• segment: add logic to connect to segment-view in componentDidLoad() callback (#30060) (000f553), closes #30000
• select-modal: match radio styles to iOS native (#30119) (3f8346e)

8.4.1

patch

November 27 2024

Bug Fixes

• header: use aria attributes to hide small title when collapsed (#30027) (23763ab), closes #29347
• menu: hide from screen readers while animating (#30036) (845071c)
• overlays: announce info after opening based on platform (#30025) (f6188c4)
• overlays: focus management with checkbox/radio (#30026) (8ee42bb)
• toast: swipe gesture works with custom container layout (#29999) (470decc), closes #29998

8.4.0

minor

November 4 2024

Bug Fixes

• alert: use correct heading structure for subHeader when header exists (#29964) (0fdcb32)

Features

• menu: pass role to ionWillClose and ionDidClose events (#29954) (ee2fa19)
• segment-view: adds support for new ion-segment-view component (#29969) (89508fb)
• select: add modal as interface (#29972) (3628ea8)

8.3.4

patch

October 30 2024

Bug Fixes

• angular: add missing 'compareWith' input to standalone ion-radio-group (#29870) (47ba703), closes #29826
• backdrop: remove tabindex for improved accessibility (#29956) (7294e96), closes #29773
• input, textarea: ensure screen readers announce helper and error text when focused (#29958) (5a73145)
• overlays: hide from screen readers while animating (#29951) (cb60073), closes #29857
• overlays: do not hide root when toast appears (#29962) (322d7c9), closes #29773
• overlays: hide the focus trap div from screen readers (#29970) (c3b58f1), closes #29858
• vue: incorrect view rendered when using router.go(-n) (#29877) (e32fbe0), closes #28201 #28201 #29847

8.3.3

patch

October 16 2024

Bug Fixes

• tabs, tab-bar: use standalone tab bar in Vue, React (#29940) (b7b383b), closes #29885 #29924

8.3.2

patch

October 2 2024

Bug Fixes

• segment: prevent flickering for scrollable on iOS (#29884) (078ed0b), closes #29523

8.3.1

patch

September 17 2024

Bug Fixes

• checkbox: align checkbox properly in item using start alignment (#29850) (88b7013), closes #29837
• datetime: display today's date and time when value is an empty string (#29839) (f1d50c0), closes #29669
• range: disable scroll when range is being dragged (#29241) (35b1a45)
• react, vue: add default value for navManager on tabs (#29865) (df39cea)
• react: revert react output target version (#29869) (f64458d), closes ionic-team/stencil-ds-output-targets#476 ionic-team/stencil-ds-output-targets#475 #29848

8.3.0

minor

September 5 2024

Features

• checkbox: display as block when justify or alignment properties are defined (#29783) (4ccd15e)
• radio: display as block when justify or alignment properties are defined (#29801) (18b02b3)
• react, vue, angular: use tabs without router (#29794) (867066b), closes #25184
• toggle: display as block when justify or alignment properties are defined (#29802) (0332c8c)

8.2.9

patch

September 17 2024

Bug Fixes

• react: revert react output target version (#29869) (6fb087f), closes ionic-team/stencil-ds-output-targets#476 ionic-team/stencil-ds-output-targets#475 #29848

8.2.8

patch

September 5 2024

Bug Fixes

• range: emit correct value when knob is at start of bar (#29820) (6a3d7c7), closes #29792
• react: intellisense works with IntelliJ (#29782) (bacded5), closes #29755

8.2.7

patch

August 13 2024

Bug Fixes

• alert: do not overwrite id set in htmlAttributes (#29708) (1295ced), closes #29704
• angular: add focusTrap prop to modal and popover (#29729) (05913c3), closes #29728
• angular: remove the tabindex set by routerLink from Ionic components (#29744) (20073e1), closes #20632
• content: allow custom roles and aria attributes to be set on content (#29753) (7b16397)
• item: router-link remains clickable with item cover (#29743) (a9f278a)
• overlays: do not overwrite id set in htmlAttributes (#29722) (92ce563), closes #29712
• react: add onPointerDown, onTouchEnd, add onTouchMove (#29736) (bfee3cd), closes #29174
• vue: pass router-link value to href to properly render clickable elements (#29745) (ab4f279)

8.2.6

patch

July 24 2024

Bug Fixes

• alert: do not overwrite id set in htmlAttributes (#29708) (1295ced), closes #29704
• angular: add focusTrap prop to modal and popover (#29729) (05913c3), closes #29728
• overlays: do not overwrite id set in htmlAttributes (#29722) (92ce563), closes #29712

8.2.5

patch

July 3 2024

Bug Fixes

• dependencies: use latest @stencil/core to remove DOMException errors (#29685) (d70ea4), closes #29681
• vue: add optional IonicConfig type parameter to IonicVue plugin (#29637) (90893f4), closes #29659

8.2.4

patch

June 28 2024

Bug Fixes

• angular: popover arrow navigation with disabled items (#29662) (ceb41f3), closes #29640

8.2.2

patch

June 12 2024

Bug Fixes

• refresher: show when content is fullscreen (#29608) (5cdfac8), closes #18714

8.2.1

patch

June 5 2024

• react: export InputInputEventDetail type (#29512) (624ceba), closes #29518

8.2.0

minor

May 22 2024

Features

• angular: setting props on a signal works (#29453) (4640e04), closes #28876

8.1.3

patch

May 22 2024

Bug Fixes

• core: malformed URIs will not throw exception (#29486) (4a41983), closes #29479

8.1.2

patch

May 15 2024

Bug Fixes

• many: do not grow slotted checkboxes, radios, selects and toggles (#29501) (c63d07b), closes #29423
• picker: update keyboard navigation (#29497) (32bc681)

8.1.1

patch

May 15 2024

Bug Fixes

• angular: add formatOptions property to standalone datetime (#29468) (bb1db52), closes #29464
• angular: persist select disabled state in item (#29448) (dfb72d7), closes #29234
• angular: set active segment button when dynamically changing items (#29418) (ee83388), closes #29414
• radio: persist checked state when items are updated in radio-group (#29457) (7ea14ae), closes #29442

8.1.0

minor

May 1 2024

Features

• add experimental transition focus manager (#29400) (5b686ef), closes #23650
• content: add fixedSlotPlacement prop (#29233) (90a7e70)
• datetime: pass roles to overlay when dismissing (#29221) (6945adc), closes #28298
• input: add clearInputIcon property (#29246) (0f5d1c0), closes #26974
• modal, popover: add ability to temporarily disable focus trapping (#29379) (7c00351), closes #24646
• picker: picker column is easier to select with assistive technology (#29371) (e38e2e4), closes #25221

8.0.2

patch

May 1 2024

Bug Fixes

• datetime: navigating months in RTL works correctly (#29421) (4d09890), closes #29198
• ios: large title transition accounts for back button with no text (#29327) (bd8d065), closes #28751
• md: item border has improved contrast in dark mode (#29398) (fa85f03), closes #29386
• select: options are visible with fit-content width and fill outline (#29408) (f15b62a), closes #29321

8.0.1

patch

April 24 2024

Bug Fixes

• input: clear button can be navigated using screen reader (#29366) (ee49824), closes #29358
• input: debounce is set with binding syntax in angular on load (#29377) (23321f7), closes #29374

7.8.6

patch

April 24 2024

Bug Fixes

• input: clear button can be navigated using screen reader (#29366) (#29383) (5ce0c60)

To see more releases, visit GitHub.