The Section Widget displays section titles and organizes content into logical groups. Section widgets are always visible to the end user.
Summary widgets MUST be the first widget created in every sheet

Example Code

{
  "type": "sheetTemplateWidgets",
  "attributes": {
    "type": "section",
    "label": "",
    "referenceId": "",
    "collapsed": false,
    "visibleIf": null,
    "description": null,
    "references": null,
    "authorNotes": null,
    "referenceImage": null
  }
}

Parameters

type
string
required
Must be โ€œsectionโ€ - defines the widget type
label
string
required
The name of the widget, shows up as the section title
referenceId
string
required
Unique reference ID of the widget
collapsed
boolean
default:"false"
Whether the section is collapsible, and if so, it will begin as collapsed
visibleIf
string (equation)
default:"true"
An equation that must result in true/false and can hide the widget if certain conditions are met
description
string
Description of section (not currently displayed, but will be in future)
references
string
required
Relevant code or standard reference for the section
authorNotes
string
Make notes relevant to internal development here; this will never be displayed publicly
referenceImage
string (image dataURI)
Any image specifically relevant to the widget

Best Practices

  • Use descriptive section labels that clearly indicate the content within
  • Include relevant code references in the references field
  • Consider using collapsed sections for advanced or less commonly used options
  • Always create a Summary section as the first widget in every sheet