An Introduction to JSON

An Introduction to JSON


JSON, short for JavaScript Object Notation, is a format for sharing data. As its name suggests, JSON is derived from the JavaScript programming language, but it’s available for use by many languages including Python, Ruby, PHP, and Java. JSON is usually pronounced like the name “Jason.”

JSON is also readable, lightweight, offers a good alternative to XML, and requires much less formatting. This informational guide will discuss the data you can use in JSON files and the general structure and syntax of this format.

Understanding Syntax and Structure

JSON uses the .json extension when it stands alone, and when it’s defined in another file format (as in .html), it can appear inside of quotes as a JSON string, or it can be an object assigned to a variable. This format transmits between web server and client or browser.

A JSON object is a key-value data format that is typically rendered in curly braces. When you’re working with JSON, you’ll likely come across JSON objects in a .json file, but they can also exist as a JSON object or string within the context of a program.

Here is an example of a JSON object:

  "first_name" : "Sammy",
  "last_name" : "Shark",
  "location" : "Ocean",
  "online" : true,
  "followers" : 987 

Although this is a short example, and JSON can be many lines long, this demonstrates that the format is generally set up with two curly braces (or curly brackets) that are represented with { } on either end of it, and with key-value pairs populating the space between. Most data used in JSON ends up being encapsulated in a JSON object.

Key-value pairs have a colon between them as in "key" : "value". Each key-value pair is separated by a comma, so the middle of a JSON lists as follows: "key" : "value", "key" : "value", "key": "value". In the previous example, the first key-value pair is "first_name" : "Sammy".

JSON keys are on the left side of the colon. They need to be wrapped in double quotation marks, as in "key", and can be any valid string. Within each object, keys need to be unique. These key strings can include whitespaces, as in "first name", but that can make it harder to access when you’re programming, so it’s best to use underscores, as in "first_name".

JSON values are found to the right of the colon. At the granular level, these need to be one of following six data types:

  • strings
  • numbers
  • objects
  • arrays
  • Booleans (true or false)
  • null

At the broader level, values can also be made up of the complex data types of JSON object or array, which is discussed in the next section.

Each of the data types that are passed in as values into JSON will maintain their own syntax, meaning strings will be in quotes, but numbers will not be.

With .json files, you’ll typically get a format expanded over multiple lines, but JSON can also be written all in one line, as in the following example:

{ "first_name" : "Sammy", "last_name": "Shark",  "online" : true, }

This is more common within another file type or when you encounter a JSON string.

Writing the JSON format on multiple lines often makes it much more readable, especially when dealing with a large data set. Because JSON ignores whitespace between its elements, you can space out your colons and key-value pairs in order to make the data even more human readable:

  "first_name"  :  "Sammy", 
  "last_name"   :  "Shark", 
  "online"      :  true 

It is important to keep in mind that though they appear similar, a JSON object is not the same format as a JavaScript object, so though you can use functions within JavaScript objects, you cannot use them as values in JSON. The most important attribute of JSON is that it can be readily transferred between programming languages in a format that all of the participating languages can work with. In contrast, JavaScript objects can only be worked with directly through the JavaScript programming language.

JSON can become increasingly complex with hierarchies that are comprised of nested objects and arrays. Next, you’ll learn more about these complex structures.

Working with Complex Types in JSON

JSON can store nested objects in JSON format in addition to nested arrays. These objects and arrays will be passed as values assigned to keys, and may be comprised of key-value pairs as well.

Nested Objects

In the following users.json file, for each of the four users ("sammy", "jesse", "drew", "jamie") there is a nested JSON object passed as the value for each of them, with its own nested keys of "username" and "location" that relate to each of the users. Each user entry in the following code block is an example of a nested JSON object:

  "sammy" : {
    "username"  : "SammyShark",
    "location"  : "Indian Ocean",
    "online"    : true,
    "followers" : 987
  "jesse" : {
    "username"  : "JesseOctopus",
    "location"  : "Pacific Ocean",
    "online"    : false,
    "followers" : 432
  "drew" : {
    "username"  : "DrewSquid",
    "location"  : "Atlantic Ocean",
    "online"    : false,
    "followers" : 321
  "jamie" : {
    "username"  : "JamieMantisShrimp",
    "location"  : "Pacific Ocean",
    "online"    : true,
    "followers" : 654

In this example, curly braces are used throughout to form a nested JSON object with associated username and location data for each of the four users. As with any other value, when using objects, commas are used to separate elements.

Nested Arrays

Data can also be nested within the JSON format by using JavaScript arrays that are passed as a value. JavaScript uses square brackets [ ] on either end of its array type. Arrays are ordered collections and can contain values of different data types.

For example, you may use an array when dealing with a lot of data that can be grouped together, like when there are various websites and social media profiles associated with a single user.

With the first nested array, a user profile for "Sammy" may be represented as follows:

  "first_name" : "Sammy",
  "last_name" : "Shark",
  "location" : "Ocean",
  "websites" : [
      "description" : "work",
      "URL" : "https://www.digitalocean.com/"
      "desciption" : "tutorials",
      "URL" : "https://www.digitalocean.com/community/tutorials"
  "social_media" : [
      "description" : "twitter",
      "link" : "https://twitter.com/digitalocean"
      "description" : "facebook",
      "link" : "https://www.facebook.com/DigitalOceanCloudHosting"
      "description" : "github",
      "link" : "https://github.com/digitalocean"

The "websites" key and "social_media" key each use an array to nest information belonging to Sammy’s two website links and three social media profile links. You can identify that those are arrays because of the use of square brackets.

Using nesting within your JSON format allows you to work with more complicated and hierarchical data.

Comparing JSON to XML

XML, or eXtensible Markup Language, is a way to store accessible data that can be read by both humans and machines. The XML format is available for use across many programming languages.

In many ways, XML is similar to JSON, but it requires much more text, making it longer and more time-consuming to read and write. XML must also be parsed with an XML parser, but JSON can be parsed with a standard function. Also, unlike JSON, XML cannot use arrays.

Here’s an example of the XML format:

        <username>SammyShark</username> <location>Indian Ocean</location>
        <username>JesseOctopus</username> <location>Pacific Ocean</location>
        <username>DrewSquir</username> <location>Atlantic Ocean</location>
        <username>JamieMantisShrimp</username> <location>Pacific Ocean</location>

Now, compare the same data rendered in JSON:

{"users": [
  {"username" : "SammyShark", "location" : "Indian Ocean"},
  {"username" : "JesseOctopus", "location" : "Pacific Ocean"},
  {"username" : "DrewSquid", "location" : "Atlantic Ocean"},
  {"username" : "JamieMantisShrimp", "location" : "Pacific Ocean"}
] }

JSON is much more compact and does not require end tags while XML does. Additionally, XML is not making use of an array as this example of JSON does (which you can tell through the use of square brackets).

If you are familiar with HTML, you’ll notice that XML is quite similar in its use of tags. While JSON is leaner and less verbose than XML and quick to use in many situations, including AJAX applications, you first want to understand the type of project you’re working on before deciding what data structures to use.


JSON is a lightweight format that enables you to share, store, and work with data. As a format, JSON has been experiencing increased support in APIs, including the Twitter API. JSON is also a natural format to use in JavaScript and has many implementations available for use in various popular programming languages. You can read the full language support on the “Introducing JSON” site.

Because you likely won’t be creating your own .json files but procuring them from other sources, it is important to think less about JSON’s structure and more about how to best use JSON in your programs. For example, you can convert CSV or tab-delimited data that you may find in spreadsheet programs into JSON by using the open-source tool Mr. Data Converter. You can also convert XML to JSON and vice versa with the Creative Commons-licensed utilities-online.info site.

Finally, when translating other data types to JSON, or creating your own, you can validate your JSON with JSONLint, and test your JSON in a web development context with JSFiddle.

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about our products

About the authors

Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?

This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

This comment has been deleted

    Quite useful for beginner! jsonlint.com is great tool to validate json format,and i also use jsonhome.com to edit/format json.

    Quiet useful for beginner!

    Great article. Concise and very clear. I am curious if there is currently a way to export Excel data directly to JSON, instead of to .csv and then converting using a separate utility? Thanks

    Hey, found your article while surfing on info about learning JSON, maybe you should expand your article like guys did here - https://developer.mozilla.org/en-AU/docs/Learn/JavaScript/Objects/JSON

    Thanks for writing this, very clear and well-written. I’m an amateur, new to Javascript and just heard of JSON recently. It seems like a very good thing, but I’m not sure where or when to use it. I’ve been experimenting on a project using PHP to get data from a mysql server database, and learned from an online course how to make tables in PHP to display the data on a website. I like the fact that the PHP is not viewable (as tho I wrote all those table rows by hand!). So I’m not sure how or why I would use JSON if PHP is already sending and formatting the data. However, I do foresee tying to live-update the table as data is added, which I understood AJAX to be used for, so I’m wondering if JSON is just a non-XML version of AJAX? And would it seem to you that JSON would help me achieve that instead of or along with PHP? Can you show me sample code to make use of JSON from a PHP (or whatever) file? Thanks in advance Nate

    Hi, It’s not a comment it’s a question I’m a beginner in this language and i have some knowledgement in JavaScript. I should like to change the link in a JSon file, but i ignore the syntax. The line is : “id”: “1”, “link”: “#”, “src”: “https://picsum.photos/1920/776/?random”,

    I should like to change the “src”: “http…” by a picture in a file in my server. What do I have to write ?

    Many Thanks for your help Best regards CP

    Try DigitalOcean for free

    Click below to sign up and get $200 of credit to try our products over 60 days!

    Sign up

    Join the Tech Talk
    Success! Thank you! Please check your email for further details.

    Please complete your information!

    Featured on Community

    Get our biweekly newsletter

    Sign up for Infrastructure as a Newsletter.

    Hollie's Hub for Good

    Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

    Become a contributor

    Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

    Welcome to the developer cloud

    DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

    Learn more
    DigitalOcean Cloud Control Panel