setItemJson - Methods - Author API

Author API Methods


Sets the Item JSON for the current Item being edited.

You would want to use this method so that you can programatically set specific standard attributes, content, Questions or Features for new Items, for example.


var hasUpdatedJson = authorApp.setItemJson({
    "item": {
        "reference": "example-item-1",
        "title": "My Item title",
        "definition": {
            "widgets": [{
                "reference": "example-widget-ref1"
    "questions": [{
        "reference": "example-widget-ref1",
        "widget_type": "response",
        "data": {
            "stimulus": "This is the stimulus.",
            "type": "shorttext"
        "type": "shorttext"


  • itemJson itemJson

    The Item JSON.

Return value

Type boolean

Returns true if the provided itemJson is valid and the Item editor view has started updating and rendering the Item's Questions and Features.

Returns false if unable to set the Item JSON. For example, if the Item reference in the JSON is invalid or if not in the Item editor view.

Type definitions

  • itemJson object

    • features array[widgetObject]

      Array of Widget objects for Features in the Item.

    • item object

      The settings and contents of the Item.

    • questions array[widgetObject]

      Array of Widget objects for Questions in the Item.

Related articles

  • The getItem() method, which allows you to get the current Item JSON.
Was this article helpful?

Did you arrive here by accident? If so, learn more about Learnosity.