@react-native-picker/picker and react-native-dropdown-picker both handle single-selection inputs in React Native apps, but they solve the problem in fundamentally different ways. @react-native-picker/picker is a community-maintained wrapper around the native iOS and Android picker components, offering a look and feel that matches the operating system. react-native-dropdown-picker is a fully customizable JavaScript-based component that draws its own dropdown interface, allowing for consistent styling across platforms but requiring more manual state management.
Both @react-native-picker/picker and react-native-dropdown-picker handle single-selection inputs in React Native apps, but they work differently under the hood. One relies on the operating system's built-in controls, while the other draws its own interface using JavaScript. Let's compare how they tackle common development problems.
@react-native-picker/picker renders actual native UI components.
UIPickerView.Spinner or Dialog depending on the mode.// @react-native-picker/picker: Native rendering
import { Picker } from '@react-native-picker/picker';
<Picker
selectedValue={selectedValue}
onValueChange={(itemValue) => setSelectedValue(itemValue)}
>
<Picker.Item label="Apple" value="apple" />
<Picker.Item label="Banana" value="banana" />
</Picker>
react-native-dropdown-picker draws the UI using React Native views.
View, Text, and TouchableOpacity.// react-native-dropdown-picker: JS rendering
import DropDownPicker from 'react-native-dropdown-picker';
<DropDownPicker
open={open}
value={value}
items={items}
setOpen={setOpen}
setValue={setValue}
setItems={setItems}
/>
@react-native-picker/picker uses a simple controlled model.
// @react-native-picker/picker: Simple state
const [selectedValue, setSelectedValue] = useState('apple');
<Picker selectedValue={selectedValue} onValueChange={setSelectedValue}>
<Picker.Item label="Apple" value="apple" />
</Picker>
react-native-dropdown-picker requires multiple state variables.
// react-native-dropdown-picker: Complex state
const [open, setOpen] = useState(false);
const [value, setValue] = useState(null);
const [items, setItems] = useState([
{ label: 'Apple', value: 'apple' },
{ label: 'Banana', value: 'banana' }
]);
<DropDownPicker open={open} value={value} items={items} setOpen={setOpen} setValue={setValue} setItems={setItems} />
@react-native-picker/picker has limited styling options.
// @react-native-picker/picker: Limited style props
<Picker
style={{ height: 50, width: 200 }}
dropdownIconColor="blue"
dropdownIconRippleColor="red"
>
<Picker.Item label="Apple" value="apple" color="green" />
</Picker>
react-native-dropdown-picker allows deep customization.
// react-native-dropdown-picker: Deep customization
<DropDownPicker
open={open}
value={value}
items={items}
setOpen={setOpen}
setValue={setValue}
setItems={setItems}
containerStyle={{ height: 40 }}
style={{ backgroundColor: '#fafafa' }}
dropDownContainerStyle={{ backgroundColor: '#eee' }}
/>
@react-native-picker/picker adapts to each platform.
// @react-native-picker/picker: Platform specific mode
<Picker
mode="dialog" // Android only: forces dialog mode
selectedValue={selectedValue}
onValueChange={setSelectedValue}
>
<Picker.Item label="Apple" value="apple" />
</Picker>
react-native-dropdown-picker behaves consistently everywhere.
// react-native-dropdown-picker: Consistent behavior
<DropDownPicker
open={open}
value={value}
items={items}
setOpen={setOpen}
setValue={setValue}
setItems={setItems}
zIndex={3000} // Manual z-index management required
zIndexInverse={1000}
/>
These components are great for single selection, but consider alternatives when:
@react-native-picker/picker (limited) or a dedicated multi-select library instead.react-native-dropdown-picker supports search, but @react-native-picker/picker does not.| Feature | @react-native-picker/picker | react-native-dropdown-picker |
|---|---|---|
| Rendering | π± Native OS Components | π¨ JavaScript Views |
| State Management | π’ Simple (Value only) | π Complex (Open, Value, Items) |
| Customization | π Limited to system styles | π Full control over UI |
| Platform Feel | π iOS / π€ Android differ | π Consistent across platforms |
| Search Support | β No | β Yes |
| Maintenance | π‘οΈ Official Community Module | π οΈ Third-Party Library |
@react-native-picker/picker is like the standard tool kit π§βit works out of the box, feels native, and rarely breaks when you update React Native. Ideal for internal tools, settings screens, and forms where speed and stability matter more than unique branding.
react-native-dropdown-picker is like a custom design kit π¨βperfect for consumer-facing apps where every pixel must match your brand guide. It shines when you need search functionality or a specific interaction model that native components do not support.
Final Thought: Despite their differences, both packages aim to solve the same problem: letting users choose one option from a list. Choose based on whether you prioritize native stability or design flexibility.
Choose @react-native-picker/picker when you want the standard native experience, need maximum stability with OS updates, and do not require heavy visual customization. It is the safest bet for forms that need to feel like part of the OS and works well for simple selection tasks where platform consistency is less critical than native performance.
Choose react-native-dropdown-picker when your design system requires a specific look that differs from the native picker, or when you need features like search inside the dropdown. It is suitable for projects where brand consistency across iOS and Android outweighs native feel, and your team can manage the additional state complexity.
@react-native-picker/picker| Android | iOS | PickerIOS |
|---|---|---|
![]() | ![]() | ![]() |
| Windows | MacOS |
|---|---|
![]() | ![]() |
| @react-native-picker/picker | react-native | react-native-windows |
|---|---|---|
| >= 2.0.0 | 0.61+ | 0.64+ |
| >= 1.16.0 | 0.61+ | 0.61+ |
| >= 1.2.0 | 0.60+ or 0.59+ with Jetifier | N/A |
| >= 1.0.0 | 0.57 | N/A |
$ npm install @react-native-picker/picker --save
or
$ yarn add @react-native-picker/picker
As react-native@0.60 and above supports autolinking there is no need to run the linking process.
Read more about autolinking here. This is supported by react-native-windows@0.64 and above.
CocoaPods on iOS needs this extra step:
npx pod-install
No additional step is required.
Usage in Windows without autolinking requires the following extra steps:
ReactNativePicker project to your solution.D:\dev\RNTest\node_modules\@react-native-picker\picker\windows\ReactNativePicker\ReactNativePicker.vcxprojAdd a reference to ReactNativePicker to your main application project. From Visual Studio 2019:
Right-click main application project > Add > Reference...
Check ReactNativePicker from Solution Projects.
Add #include "winrt/ReactNativePicker.h" to the headers included at the top of the file.
Add PackageProviders().Append(winrt::ReactNativePicker::ReactPackageProvider()); before InitializeComponent();.
CocoaPods on MacOS needs this extra step (called from the MacOS directory)
pod install
The following steps are only necessary if you are working with a version of React Native lower than 0.60
$ react-native link @react-native-picker/picker
Libraries β Add Files to [your project's name]node_modules β @react-native-picker/picker and add RNCPicker.xcodeprojlibRNCPicker.a to your project's Build Phases β Link Binary With LibrariesCmd+R)<android/app/src/main/java/[...]/MainApplication.java)import com.reactnativecommunity.picker.RNCPickerPackage; to the imports at the top of the filenew RNCPickerPackage() to the list returned by the getPackages() methodandroid/settings.gradle:
include ':@react-native-picker_picker'
project(':@react-native-picker_picker').projectDir = new File(rootProject.projectDir, '../node_modules/@react-native-picker/picker/android')
android/app/build.gradle:
implementation project(path: ':@react-native-picker_picker')
Libraries β Add Files to [your project's name]node_modules β @react-native-picker/picker and add RNCPicker.xcodeprojlibRNCPicker.a to your project's Build Phases β Link Binary With LibrariesCmd+R)<you need to add android:supportsRtl="true" to AndroidManifest.xml
<application
...
android:supportsRtl="true">
Import Picker from @react-native-picker/picker:
import {Picker} from '@react-native-picker/picker';
Create state which will be used by the Picker:
const [selectedLanguage, setSelectedLanguage] = useState();
Add Picker like this:
<Picker
selectedValue={selectedLanguage}
onValueChange={(itemValue, itemIndex) =>
setSelectedLanguage(itemValue)
}>
<Picker.Item label="Java" value="java" />
<Picker.Item label="JavaScript" value="js" />
</Picker>
If you want to open/close picker programmatically on android (available from version 1.16.0+), pass ref to Picker:
const pickerRef = useRef();
function open() {
pickerRef.current.focus();
}
function close() {
pickerRef.current.blur();
}
return <Picker
ref={pickerRef}
selectedValue={selectedLanguage}
onValueChange={(itemValue, itemIndex) =>
setSelectedLanguage(itemValue)
}>
<Picker.Item label="Java" value="java" />
<Picker.Item label="JavaScript" value="js" />
</Picker>
onValueChangeCallback for when an item is selected. This is called with the following parameters:
itemValue: the value prop of the item that was selecteditemPosition: the index of the selected item in this picker| Type | Required |
|---|---|
| function | No |
selectedValueValue matching value of one of the items. Can be a string or an integer.
| Type | Required |
|---|---|
| any | No |
style| Type | Required |
|---|---|
| pickerStyleType | No |
testIDUsed to locate this view in end-to-end tests.
| Type | Required |
|---|---|
| string | No |
enabledIf set to false, the picker will be disabled, i.e. the user will not be able to make a selection.
| Type | Required | Platform |
|---|---|---|
| bool | No | Android, Web, Windows |
modeOn Android, specifies how to display the selection items when the user taps on the picker:
| Type | Required | Platform |
|---|---|---|
| enum('dialog', 'dropdown') | No | Android |
dropdownIconColorOn Android, specifies color of dropdown triangle. Input value should be value that is accepted by react-native processColor function.
| Type | Required | Platform |
|---|---|---|
| ColorValue | No | Android |
dropdownIconRippleColorOn Android, specifies ripple color of dropdown triangle. Input value should be value that is accepted by react-native processColor function.
| Type | Required | Platform |
|---|---|---|
| ColorValue | No | Android |
promptPrompt string for this picker, used on Android in dialog mode as the title of the dialog.
| Type | Required | Platform |
|---|---|---|
| string | No | Android |
itemStyleStyle to apply to each of the item labels.
| Type | Required | Platform |
|---|---|---|
| text styles | No | iOS, Windows |
numberOfLinesOn Android & iOS, used to truncate the text with an ellipsis after computing the text layout, including line wrapping, such that the total number of lines does not exceed this number. Default is '1'
| Type | Required | Platform |
|---|---|---|
| number | No | Android, iOS |
onBlur| Type | Required | Platform |
|---|---|---|
| function | No | Android |
onFocus| Type | Required | Platform |
|---|---|---|
| function | No | Android |
selectionColor| Type | Required | Platform |
|---|---|---|
| ColorValue | No | iOS |
blur (Android only, lib version 1.16.0+)Programmatically closes picker
focus (Android only, lib version 1.16.0+)Programmatically opens picker
Props that can be applied to individual Picker.Item
labelDisplayed value on the Picker Item
| Type | Required |
|---|---|
| string | Yes |
valueActual value on the Picker Item
| Type | Required |
|---|---|
| number,string | Yes |
colorDisplayed color on the Picker Item
| Type | Required |
|---|---|
| ColorValue | No |
fontFamilyDisplayed fontFamily on the Picker Item
| Type | Required |
|---|---|
| string | No |
styleStyle to apply to individual item labels.
| Type | Required | Platform |
|---|---|---|
| ViewStyleProp | No | Android |
enabledIf set to false, the specific item will be disabled, i.e. the user will not be able to make a selection
@default: true
| Type | Required | Platform |
|---|---|---|
| boolean | No | Android |
contentDescriptionSets the content description to the Picker Item
| Type | Required | Platform |
|---|---|---|
| string | No | Android |
itemStyle| Type | Required |
|---|---|
| text styles | No |
onValueChange| Type | Required |
|---|---|
| function | No |
selectedValue| Type | Required |
|---|---|
| any | No |
selectionColor| Type | Required | Platform |
|---|---|---|
| ColorValue | No | iOS |
themeVariant| Type | Required |
|---|---|
| enum('light', 'dark') | No |