A ScrollView placed inside a View will not scroll in React Native
ScrollView does not scrollShort answer
A ScrollView only scrolls when its height is bounded. If any parent View has no flex or fixed height, the ScrollView grows to fit its content and has nothing to scroll. Pass flex: 1 down every parent. For a scroller inside another scroller on Android, set nestedScrollEnabled.
Fix it fast
1Find out which cause you have
Turn on the element inspector and select the ScrollView. If its height equals its content height, a parent is not bounded. Or list the parents' styles.
grep -n -B6 "<ScrollView" src/screens/*.tsx2Match what you see, then jump to its fix
- 1
The ScrollView is as tall as all its children, so it is clipped by the screen and never scrolls.A parent View has no bounded heightFix - 2
The inner scroller does not move on Android while the outer one takes the gesture.A vertical scroller inside another vertical scroller on AndroidFix - 3
Console error in development: VirtualizedLists should never be nested inside plain ScrollViews with the same orientationA FlatList is nested in a ScrollView with the same directionFix
- 1
What does the error look like?
ScrollView does not scrollcontent is cut off at the bottom of the screenVirtualizedLists should never be nested inside plain ScrollViews with the same orientation
Cause 1 of 3
A parent View has no bounded height
1Check
Walk up from the ScrollView to the screen root. Every View on the way needs flex: 1 or a fixed height.
grep -n "style={\|flex" src/screens/MyScreen.tsx2Fix
Give each parent flex: 1 so the height passes down to the ScrollView. Setting a fixed height on the ScrollView also works but the docs discourage it.
<View style={{ flex: 1 }}>
<View style={{ flex: 1 }}>
<ScrollView>
{/* content */}
</ScrollView>
</View>
</View>3Verify
Reload and drag the content. The inspector now shows the ScrollView at screen height with taller content inside.
# Dev menu > Show Element InspectorConfirmed by reactnative.dev
Cause 2 of 3
A vertical scroller inside another vertical scroller on Android
1Check
Look for a ScrollView within a ScrollView that scrolls in the same direction.
grep -n "ScrollView" src/screens/MyScreen.tsx2Fix
Set nestedScrollEnabled on the inner ScrollView. It is Android only, API level 21 and up, and false by default.
<ScrollView>
<ScrollView nestedScrollEnabled style={{ maxHeight: 240 }}>
{/* inner content */}
</ScrollView>
</ScrollView>3Verify
On an Android device or emulator, drag inside the inner area. It scrolls on its own.
npx react-native run-androidConfirmed by reactnative.dev
Cause 3 of 3
A FlatList is nested in a ScrollView with the same direction
1Check
In dev builds React Native logs this error when a list is inside a plain ScrollView and the list can scroll.
grep -n -B3 "<FlatList" src/screens/MyScreen.tsx2Fix
Use one scroller. Put the other content in ListHeaderComponent and ListFooterComponent of the FlatList and remove the outer ScrollView.
<FlatList
data={items}
renderItem={renderItem}
ListHeaderComponent={<Header />}
ListFooterComponent={<Footer />}
/>3Verify
Reload in development. The error no longer appears and the whole screen scrolls.
npx react-native start --reset-cacheConfirmed by raw.githubusercontent.com
How do I stop it coming back?
- Pass flex: 1 from the screen root down to every scroller.
- Use one vertical scroller per screen and put extra content in list header and footer slots.
- Test scrolling on Android and iOS, since nested behaviour differs.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.
Which stack is behind this page?
Projects of mine built on the same technologies:
- QistLockA NestJS and React SaaS driving an Android Device Owner agent that locks financed phones when payments lapse.
- TaxiDexMy own multi-tenant taxi dispatch SaaS: API, dispatcher portal, driver and passenger apps, and the servers underneath.
- TaskvareA task and project-management suite: React on the web, Flutter on mobile, TypeScript underneath.
Related fixes
Mobile apps
React Native FlatList warns that it is slow to update and scrolls with lag
make sure your renderItem function renders components that follow React performance best practices like PureComponent, shouldComponentUpdate, etc.
React Native logs this message when scroll events arrive more than 500 ms apart on a list longer than five screens.
4 causes, each with a fixMobile apps
Axios request works on iOS or in a browser but fails on Android with Network Error
AxiosError: Network Error
A React Native app has no CORS, so on Android a Network Error usually means the request never reached the server.
3 causes, each with a fixMobile apps
Axios returns Network Error in a React Native app on iPhone or the iOS Simulator
error.code is ERR_NETWORK and error.response is undefined
A Network Error means iOS stopped the request before any HTTP answer came back.
3 causes, each with a fixMobile apps
backgroundImage: url(...) does nothing in a React Native view
ImageBackground renders an empty area
In React Native the backgroundImage style draws linear and radial gradients, not pictures, so url(...) is ignored.
3 causes, each with a fixMobile apps
A custom font in React Native falls back to the system font
Unrecognized font family 'MyFont'
React Native does not report a missing font, it just draws the system font.
6 causes, each with a fixMobile apps
fetch fails with TypeError: Network request failed in React Native
Network request failed
Network request failed means the request never got an HTTP response, so there is no status code to read.
3 causes, each with a fix