Bookson Developer Guide

Root Object

The exported JSON file represents the entire bookmark structure along with Bookson metadata.

Field	Description
`format` string*	Must be exactly "bookson" to be recognized by the importer.
`version` number*	The schema version number. Currently 1.
`includesMetadata` boolean	Whether Bookson-specific data (tags, notes) are included.
`exportedAt` string	ISO 8601 timestamp of when the export occurred.
`name` string	Name generated for the export file/session.
`items` array*	Array of Node objects representing the bookmarks and folders.

Node Object (Item)

Each item in the items array is a Node. A Node can either be a folder (if it has children) or a bookmark (if it has a url).

Field	Description
`title` string*	The title of the folder or bookmark.
`url` string	The URL of the bookmark. If omitted, the Node is considered a folder.
`children` array	Array of child Nodes. Only present if the Node is a folder.
`tags` array of strings	List of tags assigned to this item.
`note` string	A user-defined text note for this item.
`favorite` boolean	Set to true if the item is marked as a favorite.

Sample JSON

Here is an example of a Bookson export file.

{
  "format": "bookson",
  "version": 1,
  "includesMetadata": true,
  "exportedAt": "2026-05-09T05:35:52.775Z",
  "name": "Imported from Bookson",
  "items": [
    {
      "title": "Bookmarks Bar",
      "children": [
        {
          "title": "Bookson Official",
          "url": "https://bookson.uk",
          "tags": ["Official"],
          "favorite": true
        },
        {
          "title": "About Bookson",
          "children": [
            {
              "title": "News & Updates",
              "url": "https://bookson.uk/news",
              "note": "Check for updates"
            },
            {
              "title": "Legal",
              "children": [
                {
                  "title": "Privacy Policy",
                  "url": "https://bookson.uk/privacy"
                }
              ]
            },
            {
              "title": "Bookson Family",
              "url": "https://bookson.uk/family",
              "tags": ["Tools"]
            }
          ]
        }
      ]
    }
  ]
}