PackageTrack
Sign in Get early access

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 2026
2018 2019 2020 2021 2022 2023 2024 2025 2026
Release Pre-release

Releases

latest 60 of 91
  1. 2.5.5 25 Mar 2026
    Release notes
    • Fixes dartdoc comments that accidentally used HTML.
    Open source →
  2. 2.5.4 09 Dec 2025
    Release notes
    • Updates dependencies for the shared_preferences_tool DevTools 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.
    Open source →
  3. 2.5.3 27 Mar 2025
    Release notes
    • Fixes a bug in the example app.
    Open source →
  4. 2.5.2 10 Feb 2025
    Release notes
    • Fixes setState returning Future on example/main.dart error in example code.
    Open source →
  5. 2.5.1 30 Jan 2025
    Release notes
    • Exposes SharedPreferencesOptions.
    Open source →
  6. 2.5.0 30 Jan 2025
    Release notes
    • Adds shared preferences devtools extension.
    Open source →
  7. 2.4.0 24 Jan 2025
    Release notes
    • Adds migration tool to move from legacy SharedPreferences to SharedPreferencesAsync.
    • Adds clarifying comment about allowList handling with an updated prefix.
    Open source →
  8. 2.3.5 02 Jan 2025
    Release notes
    • Adds information about Android SharedPreferences support.
    Open source →
  9. 2.3.4 18 Dec 2024
    Release notes
    • Security update, requires shared_preferences_android to be 2.3.4.
    Open source →
  10. 2.3.3 09 Nov 2024
    Release notes
    • Clarifies scope of prefix handling in README.
    Open source →
  11. 2.3.2 15 Aug 2024
    Release notes
    • Removes outdated testing information from README.
    • Updates minimum supported SDK version to Flutter 3.22/Dart 3.4.
    Open source →
  12. 2.3.1 01 Aug 2024
    Release notes
    • Fixes getStringList bug with List<Object?> cast exception.
    Open source →
  13. 2.3.0 30 Jul 2024
    Release notes
    • Adds SharedPreferencesAsync and SharedPreferencesWithCache APIs.
    • Updates minimum supported SDK version to Flutter 3.16/Dart 3.2.
    Open source →
  14. 2.2.3 11 Apr 2024
    Release notes
    • 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.
    Open source →
  15. 2.2.2 10 Oct 2023
    Release notes
    • Updates documentation for containsKey.
    Open source →
  16. 2.2.1 30 Aug 2023
    Release notes
    • 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.
    Open source →
  17. 2.2.0 30 Jun 2023
    Release notes
    • Adds allowList option to setPrefix.
    Open source →
  18. 2.1.2 08 Jun 2023
    Release notes
    • 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.
    Open source →
  19. 2.1.1 08 May 2023
    Release notes
    • Updates iOS minimum version in README.
    Open source →
  20. 2.1.0 31 Mar 2023
    Release notes
    • Adds setPrefix method.
    Open source →
  21. 2.0.20 21 Mar 2023
    Release notes
    • Adds README discussion of reload().
    Open source →
  22. 2.0.18 22 Feb 2023
    Release notes
    • Updates links for the merge of flutter/plugins into flutter/packages.
    • Updates minimum Flutter version to 3.0.
    Open source →
  23. 2.0.17 20 Jan 2023
    Release notes
    • Updates code for stricter lint checks.
    Open source →
  24. 2.0.16 12 Jan 2023
    Release notes
    • Switches to the new shared_preferences_foundation implementation package for iOS and macOS.
    • Updates code for no_leading_underscores_for_local_identifiers lint.
    • Updates minimum Flutter version to 2.10.
    Open source →
  25. 2.0.15 11 May 2022
    Release notes
    • Minor fixes for new analysis options.
    Open source →
  26. 2.0.14 10 May 2022
    Release notes
    • 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.
    Open source →
  27. 2.0.13 04 Feb 2022
    Release notes
    • Updates documentation on README.md.
    Open source →
  28. 2.0.12 10 Jan 2022
    Release notes
    • Removes dependency on meta.
    Open source →
  29. 2.0.11 10 Dec 2021
    Release notes
    • Corrects example for mocking in readme.
    Open source →
  30. 2.0.10 09 Dec 2021
    Release notes
    • Removes obsolete manual registration of Windows and Linux implementations.
    Open source →
  31. 2.0.9 19 Nov 2021
    Release notes
    • Fixes newly enabled analyzer options.
    • Updates example app Android compileSdkVersion to 31.
    • Moved Android and iOS implementations to federated packages.
    Open source →
  32. 2.0.8 17 Sep 2021
    Release notes
    • Update minimum Flutter SDK to 2.5 and iOS deployment target to 9.0.
    Open source →
  33. 2.0.7 23 Aug 2021
    Release notes
    • Add iOS unit test target.
    • Updated Android lint settings.
    • Fix string clash with double entries on Android
    Open source →
  34. 2.0.6 25 May 2021
    Release notes
    • Migrate maven repository from jcenter to mavenCentral.
    Open source →
  35. 2.0.5 16 Mar 2021
    Release notes
    • Fix missing declaration of windows' default_package
    Open source →
  36. 2.0.4 10 Mar 2021
    Release notes
    • Fix a regression with simultaneous writes on Android.
    Open source →
  37. 2.0.3 02 Mar 2021
    Release notes
    • Android: don't create additional Handler when method channel is called.
    Open source →
  38. 2.0.2 02 Mar 2021
    Release notes
    • Don't create additional thread pools when method channel is called.
    Open source →
  39. 2.0.1 25 Feb 2021
    Release notes
    Open source →
  40. 2.0.0 23 Feb 2021
    Release notes
    • 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, use remove(key) instead.
    Open source →
  41. 2.0.0-nullsafety.1 18 Feb 2021 pre-release

    Nothing published for this version

  42. 2.0.0-nullsafety 09 Feb 2021 pre-release

    Nothing published for this version

  43. 0.5.12 23 Sep 2020
    Release notes
    • Keep handling deprecated Android v1 classes for backward compatibility.
    Open source →
  44. 0.5.12+2 14 Oct 2020
    Release notes
    • Update android compileSdkVersion to 29.
    Open source →
  45. 0.5.12+4 03 Nov 2020
    Release notes
    • Remove unused test dependency.
    Open source →
  46. 0.5.11 22 Sep 2020
    Release notes
    • Support Windows by default.
    Open source →
  47. 0.5.10 22 Aug 2020
    Release notes
    • Update package:e2e -> package:integration_test
    Open source →
  48. 0.5.8 08 Jul 2020
    Release notes
    • Support Linux by default.
    Open source →
  49. 0.5.7 21 Apr 2020
    Release notes
    • Remove Android dependencies fallback.
    • Require Flutter SDK 1.12.13+hotfix.5 or greater.
    • Fix CocoaPods podspec lint warnings.
    Open source →
  50. 0.5.7+1 06 May 2020
    Release notes
    • Declare API stability and compatibility with 1.0.0 (more details at: https://github.com/flutter/flutter/wiki/Package-migration-to-1.0.0).
    Open source →
  51. 0.5.7+2 12 May 2020
    Release notes
    • Update lower bound of dart dependency to 2.1.0.
    Open source →
  52. 0.5.7+3 21 May 2020
    Release notes
    • Post-v2 Android embedding cleanup.
    Open source →
  53. 0.5.6 11 Dec 2019
    Release notes
    • Support web by default.
    • Require Flutter SDK 1.12.13+hotfix.4 or greater.
    Open source →
  54. 0.5.6+1 23 Jan 2020
    Release notes
    • Updated README
    Open source →
  55. 0.5.6+2 20 Feb 2020
    Release notes
    • Make the pedantic dev_dependency explicit.
    Open source →
  56. 0.5.6+3 10 Mar 2020
    Release notes
    • Fix deprecated API usage warning.
    Open source →
  57. 0.5.5 10 Dec 2019
    Release notes
    • Support macos by default.
    Open source →
  58. 0.5.4 22 Oct 2019
    Release notes
    • Support the v2 Android embedding.
    • Update to AndroidX.
    • Migrate to using the new e2e test binding.
    Open source →
  59. 0.5.4+1 25 Oct 2019
    Release notes
    • Include lifecycle dependency as a compileOnly one on Android to resolve potential version conflicts with other transitive libraries.
    Open source →
  60. 0.5.4+3 28 Oct 2019
    Release notes
    • Android: Suppress casting warnings.
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive