Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Flutter and app store releases

Dart runtime error: type 'int' is not a subtype of type 'String'

Errortype 'int' is not a subtype of type 'String'

Short answer

Dart does not convert an int to a String for you. The error means a value that is really an int reached code that expects a String. It is usually a JSON field that holds a number while the model casts it as String. Convert with toString() or interpolation, or change the model's field type.

  • Applies to Dart 3, Flutter 3.x stable
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 1Find out which cause you have

    Print the runtime type of the value that fails, taken from the decoded data, not from your model.

    debugPrint('${json['id']} is ${json['id'].runtimeType}');
  2. 2Match what you see, then jump to its fix

    1. 1The trace points at fromJson, on a line with as StringA JSON number is read as a StringFix
    2. 2The trace points at a widget such as Text, or at a method with a String parameterAn int is passed where a String is requiredFix

What does the error look like?

  • type 'int' is not a subtype of type 'String'
  • Text widget given an int where a String is expected

Cause 1 of 2

A JSON number is read as a String

1Check

jsonDecode returns dynamic, so the real types are only known at runtime. A field the API sends as 12 is an int, even if your model says String.

final map = jsonDecode(body) as Map<String, dynamic>;
debugPrint(map.map((k, v) => MapEntry(k, v.runtimeType)).toString());

2Fix

Either make the model field an int, or convert when reading. Pick one meaning for the field and keep to it.

// model field is a String
id = json['id'].toString();
// or model field is an int
id = json['id'] as int;

3Verify

Decode a sample response in a unit test and check the model.

flutter test

Confirmed by docs.flutter.dev

Did this fix it?

Cause 2 of 2

An int is passed where a String is required

1Check

Dart treats int and String as unrelated types; each conversion is explicit. Text(count) with an int count is such a case.

grep -rn "Text(" lib/ | grep -v "'"

2Fix

Convert the number to a string with toString() or string interpolation.

Text(count.toString())
Text('$count')

3Verify

Hot reload and open the screen.

flutter run

Confirmed by dart.dev

Did this fix it?

How do I stop it coming back?

  • Write a fromJson test for every model using a real sample response.
  • Agree with the API owner whether ids are numbers or strings, and document it.
  • Avoid dynamic maps in widgets; convert to typed models once, at the edge.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.

Which stack is behind this page?

Projects of mine built on the same technologies:

Related fixes

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.