Automatic Json Serializing in Flutter Using Json Annotation

Dane Mackier
May 26 · 4 min read

Originally posted here

I recently wrote a post for beginner on how to parse Json in Flutter. This tutorial covers how to use json_annotation and json_serializable to generate your code for parsing and serialising your models to json.

This way is not always faster than generating your models from your json using a json to dart converter. The places I’ve seen it work better or reduce work is when you have to write custom logic around how you want to serialise and deserialise your json. Other than that it’s not very appealing if you have small models and don’t need any custom json parsing rules.


Using the json_annotation is a two step process. You have to annotate your models, and then you have to run

To generate the models and the factories for you. This is not a big deal since models don’t change often so you don’t have to do this all the time. To use this json magic we have to add the following packages:

  • json_serializable: Provides a dart build system that generates code when they find member annotated with classes defined in json_annotation
  • json_annotation: Defines the annotations used by json_serializable
  • build_runner: Provides a way to generate files using Dart code

Only the json_annotation package will be shipped as a dependency, the other two (json_serializable and build_runner) will be dev dependencies. Let’s add them to the pubspec.

Next we’ll create our model. I’ll show one exmple and display some of the functionality available to you. Create a file called user.dart with a new class

To indicate this class in serializable we have to annotate it with @JsonSerializable(). One thing to keep in mind is, you're going to be writing code that doesn't exist until the above build command is run. The way this is done is by indicating that this file is part of the generated file, and indicating to the generated file that it's apart of this file. The way we do that is through the part directive. Let's fill the class out by importing json_annotation package, including our partial file and making some basic properties.

Now before you get a fright, the code _$UserFromJson(json) will be generated by the json_serializer when we run build. Let's run the command to get the user.g.dart file. In your project folder run

You should see something similar to below, if it’s your first time it’ll be more text

You’ll see a new file created next to your user file named user.g.dart and in there is your serializing code. That’s all there is to it. As your model expands and you add new propertiesyou have to regenerate. Lets look at some of the capabilities.

This is the constructor for the JsonKey, as you see there’s many options. We’ll only look at a few to keep it short.


Using the name property you can tell the serializer what the name of the key will be in the json data. This way if you have weird keys like _GMT_time you can still map it to a value in your model without much code.

Include if Null

By using the @JsonKey annotation and passing false to includeIfNull it will be excluded from the json string.

To And From json

You can also supply toJson and fromJson functions that will take in a value and convert it to what you want. The most common application will probably be to take in a Date string and convert it to a DateTime. But we’ll do something a bit different. We’ll take in a socialID and convert it to a string representing the social platforms name.

The JsonSerializable annotation has it's own set of parameters that also allows you to customise your json handling. I won't go over all of them since you can just go to the definition and see all the properties.

Checkout and subscribe to my Youtube Channel for weekly tutorials. Follow me on Instagram for snippets and day-to-day programming. Checkout all the other snippetshere. You might find some more Flutter magic.

Flutter Community

Articles and Stories from the Flutter Community

Dane Mackier

Written by

A full stack software developer focused on building mobile products, its tools and architecture. Always reducing boiler plate code and experimenting.

Flutter Community

Articles and Stories from the Flutter Community