shared_preferences
Flutter plugin for reading and writing simple key-value pairs. Wraps NSUserDefaults on iOS and SharedPreferences on Android.
2.5.5
1000K downloads/mo
#5 most downloaded on pub.dev
flutter/packages
What this package is like to depend on
Last release 5 months ago
25 Mar 2026
Release timing varies
gaps range from 2 weeks to 9 months
Nearly every release is documented
notes for 89 of 89 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
91 releases · first in 2017
2 releases in the last 12 months
see the full history below
Release timeline
91 releases · May 2017 to Mar 2026Releases
latest 60 of 91-
2.5.525 Mar 2026 -
2.5.409 Dec 2025Release notes
Open source →- Updates dependencies for the
shared_preferences_toolDevTools extension and fixes related deprecations. - Updates minimum supported SDK version to Flutter 3.35/Dart 3.9.
- Updates README to reflect currently supported OS versions for the latest
versions of the endorsed platform implementations.
- Applications built with older versions of Flutter will continue to use compatible versions of the platform implementations.
- Updates dependencies for the
-
2.5.327 Mar 2025 -
2.5.210 Feb 2025Release notes
Open source →- Fixes
setStatereturningFutureonexample/main.darterror in example code.
- Fixes
-
2.5.130 Jan 2025 -
2.5.030 Jan 2025 -
2.4.024 Jan 2025Release notes
Open source →- Adds migration tool to move from legacy
SharedPreferencestoSharedPreferencesAsync. - Adds clarifying comment about
allowListhandling with an updated prefix.
- Adds migration tool to move from legacy
-
2.3.502 Jan 2025 -
2.3.418 Dec 2024 -
2.3.309 Nov 2024 -
2.3.215 Aug 2024Release notes
Open source →- Removes outdated testing information from README.
- Updates minimum supported SDK version to Flutter 3.22/Dart 3.4.
-
2.3.101 Aug 2024 -
2.3.030 Jul 2024Release notes
Open source →- Adds
SharedPreferencesAsyncandSharedPreferencesWithCacheAPIs. - Updates minimum supported SDK version to Flutter 3.16/Dart 3.2.
- Adds
-
2.2.311 Apr 2024Release notes
Open source →- Updates minimum supported SDK version to Flutter 3.13/Dart 3.1.
- Updates support matrix in README to indicate that iOS 11 is no longer supported.
- Clients on versions of Flutter that still support iOS 11 can continue to use this package with iOS 11, but will not receive any further updates to the iOS implementation.
- Updates minimum supported SDK version to Flutter 3.10/Dart 3.0.
- Updates minimum iOS implementation version to include a privacy manifest.
-
2.2.210 Oct 2023 -
2.2.130 Aug 2023Release notes
Open source →- Adds pub topics to package metadata.
- Updates minimum supported SDK version to Flutter 3.7/Dart 2.19.
- Fixes the example app to be debuggable on Android.
- Deletes deprecated splash screen meta-data element.
-
2.2.030 Jun 2023 -
2.1.208 Jun 2023Release notes
Open source →- Fixes singleton initialization race condition introduced during NNBD transition.
- Updates minimum supported macOS version to 10.14.
- Updates minimum supported SDK version to Flutter 3.3/Dart 2.18.
-
2.1.108 May 2023 -
2.1.031 Mar 2023 -
2.0.2021 Mar 2023 -
2.0.1822 Feb 2023Release notes
Open source →- Updates links for the merge of flutter/plugins into flutter/packages.
- Updates minimum Flutter version to 3.0.
-
2.0.1720 Jan 2023 -
2.0.1612 Jan 2023Release notes
Open source →- Switches to the new
shared_preferences_foundationimplementation package for iOS and macOS. - Updates code for
no_leading_underscores_for_local_identifierslint. - Updates minimum Flutter version to 2.10.
- Switches to the new
-
2.0.1511 May 2022 -
2.0.1410 May 2022Release notes
Open source →- Adds OS version support information to README.
- Fixes library_private_types_in_public_api, sort_child_properties_last and use_key_in_widget_constructors lint warnings.
-
2.0.1304 Feb 2022 -
2.0.1210 Jan 2022 -
2.0.1110 Dec 2021 -
2.0.1009 Dec 2021Release notes
Open source →- Removes obsolete manual registration of Windows and Linux implementations.
-
2.0.919 Nov 2021Release notes
Open source →- Fixes newly enabled analyzer options.
- Updates example app Android compileSdkVersion to 31.
- Moved Android and iOS implementations to federated packages.
-
2.0.817 Sep 2021 -
2.0.723 Aug 2021Release notes
Open source →- Add iOS unit test target.
- Updated Android lint settings.
- Fix string clash with double entries on Android
-
2.0.625 May 2021 -
2.0.516 Mar 2021 -
2.0.410 Mar 2021 -
2.0.302 Mar 2021 -
2.0.202 Mar 2021 -
2.0.125 Feb 2021 -
2.0.023 Feb 2021Release notes
Open source →- Migrate to null-safety.
Breaking changes:
- Setters no longer accept null to mean removing values. If you were previously using
set*(key, null)for removing, useremove(key)instead.
-
2.0.0-nullsafety.118 Feb 2021 pre-releaseNothing published for this version
-
2.0.0-nullsafety09 Feb 2021 pre-releaseNothing published for this version
-
0.5.1223 Sep 2020 -
0.5.12+214 Oct 2020 -
0.5.12+403 Nov 2020 -
0.5.1122 Sep 2020 -
0.5.1022 Aug 2020 -
0.5.808 Jul 2020 -
0.5.721 Apr 2020Release notes
Open source →- Remove Android dependencies fallback.
- Require Flutter SDK 1.12.13+hotfix.5 or greater.
- Fix CocoaPods podspec lint warnings.
-
0.5.7+106 May 2020Release notes
Open source →- Declare API stability and compatibility with
1.0.0(more details at: https://github.com/flutter/flutter/wiki/Package-migration-to-1.0.0).
- Declare API stability and compatibility with
-
0.5.7+212 May 2020 -
0.5.7+321 May 2020 -
0.5.611 Dec 2019Release notes
Open source →- Support
webby default. - Require Flutter SDK 1.12.13+hotfix.4 or greater.
- Support
-
0.5.6+123 Jan 2020 -
0.5.6+220 Feb 2020 -
0.5.6+310 Mar 2020 -
0.5.510 Dec 2019 -
0.5.422 Oct 2019Release notes
Open source →- Support the v2 Android embedding.
- Update to AndroidX.
- Migrate to using the new e2e test binding.
-
0.5.4+125 Oct 2019Release notes
Open source →- Include lifecycle dependency as a compileOnly one on Android to resolve potential version conflicts with other transitive libraries.
-
0.5.4+328 Oct 2019