This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.


Decode JSON-formatted text


value = jsondecode(text)



value = jsondecode(text) parses JSON text.


collapse all

Display the JSON-formatted string ["one", "two", "three"].

jsondecode('["one", "two", "three"]')
ans = 3x1 cell array
    {'one'  }
    {'two'  }

Input Arguments

collapse all

JSON-formatted text, specified as a character vector. Invalid names in the JSON text are made valid with matlab.lang.makeValidName.

Example: '{"IDs":[116,943,234,38793]}'

Data Types: char

Output Arguments

collapse all

MATLAB data returned as decoded JSON-formatted text. value depends on the data encoded in text.


JSON supports fewer data types than MATLAB. jsondecode converts JSON data types to the MATLAB data types in this table. jsondecode converts JSON object field names to MATLAB structure field names.

JSON Data Type

MATLAB Data Type

null, in numeric arrays


null, in nonnumeric arrays

Empty double []


Scalar logical


Scalar double


Character vector

Object (In JSON, object means an unordered set of name-value pairs.)

Scalar structure (Names are made valid using matlab.lang.makeValidName.)

Array, when elements are of different data types

Cell array

Array of booleans

Array of logical

Array of numbers

Array of double

Array of strings

Cell array of character vectors

Array of objects — Same field names

Structure array

Array of objects — Different field names

Cell array of scalar structures

Introduced in R2016b