Repository navigation
bug: [Ionic 9] ion-refresher throws "Make sure you use: <ion-refresher slot='fixed'>" error #31404
Description
Prerequisites
- I have read the Contributing Guidelines.
- I agree to follow the Code of Conduct.
- I have searched for existing issues that already report this problem, without success.
Ionic Framework Version
v9.x
Current Behavior
When migrating to Ionic 9 (or starting a completely fresh installation), the ion-refresher component is throwing the following console error:
[Ionic Error]: [ion-refresher] - Make sure you use: <ion-refresher slot="fixed">.
Furthermore, because of this issue, the pull-to-refresh functionality is completely broken. The ionRefresh event does not fire at all when pulling down, making it impossible to trigger the refresh logic.
Expected Behavior
The ion-refresher should work without throwing console errors, and the ionRefresh event should trigger correctly when the user performs the pull-to-refresh gesture, just like it did in previous Ionic versions.
Steps to Reproduce
You can reproduce this easily from a fresh installation:
- Create a fresh Ionic 9 project (e.g.,
ionic start my-app blank --type=react). - Add the
<IonRefresher>and<IonRefresherContent>components inside<IonContent>. - Try to perform the pull-to-refresh gesture.
- Open the console and observe the error:
[Ionic Error]: [ion-refresher] - Make sure you use: <ion-refresher slot="fixed">. - Notice that the custom function attached to the
ionRefreshevent is never called.
Note: You can also see the exact same console error happening in the official docs example here:
https://stackblitz.com/edit/dvwkzb1t-zgeyuadx?file=src%2Fmain.tsx
Code Reproduction URL
https://stackblitz.com/edit/dvwkzb1t-zgeyuadx?file=src%2Fmain.tsx
Ionic Info
Ionic:
- Ionic CLI: 7.2.1
- Ionic Framework: @ionic/react 9.0.0
Capacitor:
- Capacitor CLI: 8.5.0
- @capacitor/android: 8.5.0
- @capacitor/core: 8.5.0
- @capacitor/ios: 8.5.0
Additional Information
No response
Activity
ShaneK commentedon Aug 25, 2026
Hey! Thanks for the report. This issue has been reported previously and resolved in #31377, you can find the dev build there if you want to try it out. Note you will still need to add
slot="fixed"to your refresher, but it won't work unless you use the dev build or until the patch version with the fix releases tomorrowShaneK commentedon Aug 25, 2026
Also, if you could link where in the docs you found that stackblitz without the slot added, that would be great. In the v9 docs they should all have slot="fixed", but I must be missing where you found this one.
bipoza commentedon Aug 26, 2026
Sorry for the misunderstanding. I meant that even with
slot="fixed", the error persisted. I'm attaching a screenshot to show what I mean.Thanks for your reply!
ionitron-bot commentedon Sep 25, 2026
Thanks for the issue! This issue is being locked to prevent comments that are not relevant to the original issue. If this is still an issue with the latest version of Ionic, please create a new issue and ensure the template is fully filled out.