RefreshControl progressViewOffset not working on iOS

[yakupdurmus]

Description

The progressViewOffset prop of RefreshControl does not seem to have any effect on iOS. No matter what value is passed, the refresh indicator position remains the same. On Android, the offset works correctly and changes the vertical position of the refresh spinner as expected.

Steps to reproduce

• Render a ScrollView or FlatList with a RefreshControl.
• Set different values for progressViewOffset (e.g., 0, 60, 120).
• Observe the refresh spinner position on iOS — it does not move.

React Native Version

0.81.4

Affected Platforms

Runtime - iOS

Output of npx @react-native-community/cli info

info Fetching system and libraries information...
System:
  OS: macOS 26.0.1
  CPU: (10) arm64 Apple M1 Pro
  Memory: 227.08 MB / 16.00 GB
  Shell:
    version: "5.9"
    path: /bin/zsh
Binaries:
  Node:
    version: 22.13.0
    path: /usr/local/bin/node
  Yarn:
    version: 1.22.19
    path: /opt/homebrew/bin/yarn
  npm:
    version: 11.1.0
    path: /opt/homebrew/bin/npm
  Watchman:
    version: 2025.06.23.00
    path: /opt/homebrew/bin/watchman
Managers:
  CocoaPods:
    version: 1.14.3
    path: /Users/yakupdurmus/.rvm/gems/ruby-2.7.6/bin/pod
SDKs:
  iOS SDK:
    Platforms:
      - DriverKit 25.0
      - iOS 26.0
      - macOS 26.0
      - tvOS 26.0
      - visionOS 26.0
      - watchOS 26.0
  Android SDK: Not Found
IDEs:
  Android Studio: 2025.1 AI-251.25410.109.2511.13752376
  Xcode:
    version: 26.0.1/17A400
    path: /usr/bin/xcodebuild
Languages:
  Java:
    version: 17.0.6
    path: /usr/bin/javac
  Ruby:
    version: 2.7.6
    path: /Users/yakupdurmus/.rvm/rubies/ruby-2.7.6/bin/ruby
npmPackages:
  "@react-native-community/cli":
    installed: 20.0.0
    wanted: 20.0.0
  react:
    installed: 19.1.0
    wanted: 19.1.0
  react-native:
    installed: 0.81.4
    wanted: 0.81.4
  react-native-macos: Not Found
npmGlobalPackages:
  "*react-native*": Not Found
Android:
  hermesEnabled: true
  newArchEnabled: false
iOS:
  hermesEnabled: true
  newArchEnabled: true

Stacktrace or Logs

no crash

MANDATORY Reproducer

https://snack.expo.dev/@yakuppdurmus/missing-last-line-of-text-in-a-scrollview

Screenshots and Videos

Screen.Recording.2025-10-17.at.13.16.41.mov

[yakupdurmus]

The docs don’t mention a specific platform. React Native worked fine on iOS in v0.71.4 but broke after the RN update.

https://reactnative.dev/docs/0.81/refreshcontrol#progressviewoffset

[smallzZz8]

I have also noticed this issue as well. Anyone have a work around? Also on RN 0.81.4. I have seen some other threads from some packages where this is also an issue.

Shopify/flash-list#1931

[Mukthayar1]

Facing same issue here.
<RefreshControl refreshing={refreshing} onRefresh={() => onRefresh()} colors={['#FF0000']} tintColor="#FF0000" progressViewOffset={120} />

[smallzZz8]

I was doing some more research and I noticed that in the new 0.82.1 changelog there are these changes listed below. They all seem very relevant to this issue since its iOS only and has to deal with props not being passed. I wonder if these issues fix it. It is out of my realm of knowledge and I am not sure entirely sure what I am looking at but possibly @cipolleschi would know more.

I read somewhere that the issue doesnt happen on 0.82 but unfortunately expo latest (54) does not support RN 0.82 yet. Would be nice to get a fix for this in 0.81

• RCTPullToRefreshViewComponentView: Properly initialize the RCTPullToRefreshViewComponentView (27217e8bd6 by @cipolleschi)
• RCTReactNativeFactory: Ask the delegate for getModuleForClass and getModuleInstanceFromClass (85b47afb48 by @cipolleschi)
• ScrollView: Correctly propagate ScrollView props to RefreshControl (09daad27ea by @cipolleschi)
• ScrollView: Make sure that ScrollView recycled refresh control have the right props setup. (21b93d8d7d by @cipolleschi)