How to locally save data in Flutter using shared_preferences

Last updated on March 6, 2022 Augustus Loading... Post a comment

To store some simple data persistently, you can use the shared_preferences plugin. Data has persisted to disk asynchronously so you need to use Future, async, await. If you aren’t familiar with them, check this guide.


Below are the most commonly used methods provided by package shared_preferences:

Writing data

  • setString(String key, String value)
  • setInt(String key, int value):
  • setDouble(String key, double value)
  • setStringList(String key, List value)
  • setBool(String key, bool value)

Reading data

  • getString(String key)
  • getInt(String key)
  • getDouble(String key)
  • getStringList(String key)
  • getBool(String key)
  • containsKey(String key): Check whether key exists or not

Deleting data

  • remove(String key)
  • clear(): Remove any saved data

Complete Example

We’ll make a small Flutter application that lets the user enter his/her name and save it locally. When the app starts next time, it’ll display a text like this:

Hello [saved name]

Our app also has a button to reset the saved data (only shows up if has saved data).

1. Install shared_preferences by executing the following:

flutter pub add shared_preferences

Then run this command:

flutter pub get

2. The complete code in main.dart:

import 'package:flutter/material.dart';
import 'package:shared_preferences/shared_preferences.dart';

void main() {
  runApp(const MyApp());

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  Widget build(BuildContext context) {
    return const MaterialApp(
      // Hide the debug banner
      debugShowCheckedModeBanner: false,
      title: '',
      home: HomePage(),

class HomePage extends StatefulWidget {
  const HomePage({Key? key}) : super(key: key);

  _HomePageState createState() => _HomePageState();

class _HomePageState extends State<HomePage> {
  String? _savedName;
  final TextEditingController _nameController = TextEditingController();

  // Retrieve the saved name if it exists
  void initState() {

  Future<void> _retrieveName() async {
    final prefs = await SharedPreferences.getInstance();

    // Check where the name is saved before or not
    if (!prefs.containsKey('name')) {

    setState(() {
      _savedName = prefs.getString('name');

  Future<void> _saveName() async {
    final prefs = await SharedPreferences.getInstance();
    prefs.setString('name', _nameController.text);

  Future<void> _clearName() async {
    final prefs = await SharedPreferences.getInstance();
    // Check where the name is saved before or not
    if (!prefs.containsKey('name')) {

    await prefs.remove('name');
    setState(() {
      _savedName = null;

  Widget build(BuildContext context) {
    return Scaffold(
        appBar: AppBar(
          title: const Text(''),
        body: Padding(
            padding: const EdgeInsets.all(25),
            child: _savedName == null
                ? Column(
                    children: [
                        controller: _nameController,
                            const InputDecoration(labelText: 'Your Name'),
                          onPressed: _saveName, child: const Text('Save'))
                : Column(children: [
                      'Hello $_savedName',
                      style: const TextStyle(fontSize: 50),
                        onPressed: _clearName, child: const Text('Reset'))

Check our app:


We’ve walked through the fundamentals about shared_preferences and examined a complete example of using it in practice. There are other approaches to save data offline in Flutter. For more details, take a look at the following articles:

You can also check out our Flutter topic page or Dart topic page to see the latest tutorials and examples.

Notify of
Inline Feedbacks
View all comments

Related Articles