body
Experiments Surveys & forms In surveys, body is the descriptive text under the question; on instructions screens it is the body text of the page and list placeholders are not expanded.
body is the secondary text of a trial, the companion of head. It is used in two places:
- Form trials (
type=form): it becomes the question description, rendered as smaller text under the question title (head). It is NOT the question title; that ishead. - Instructions screens (trials with no recognizable
stimFormat):bodyis written into the main content area of the screen.
Syntax
Section titled “Syntax”Type the text you want shown into the cell; any free text works.
Before display, %variable% placeholders (such as %response%, %rt%, %correct%, %responseCode%, indexed and aggregate forms, participant fields and user variables) are substituted, on both form trials and instructions screens.
Dynamic list values in body are expanded on form trials only; instructions screens show the cell text exactly as written.
Rendering differs by trial kind:
- Form trials: inline Markdown and raw HTML both work; block-level Markdown (for example
# Heading) does not. - Instructions screens: HTML works, Markdown does not. The text is positioned 120 pixels from the top of the screen.
Options
Section titled “Options”No enumerated values. Any string is display text.
Defaults & missing values
Section titled “Defaults & missing values”If the column is absent or the cell is left blank, no body text is shown:
- Form trials: the question renders without a description line.
- Instructions screens: the content area keeps whatever the
contentcolumn already put there.
Works with
Section titled “Works with”head: companion column;headis the question title,bodythe smaller description under it. WithresponseRows, both apply to the containing panel or matrix, not to the individual response rows.content: on instructions screens,contentis displayed first andbodyis then written into the same area. A filledbodyreplacescontent; an emptybodyleavescontentvisible.- Feedback screens redisplay
titleandheadbut neverbody. - Mobile layout on instructions screens is chosen from
titleandheadonly;bodyplays no part. - JSON forms defined with the
formcolumn do not readbody. - Results output: the cell value is echoed into the results file for each trial, like every recognized column.
Examples
Section titled “Examples”| type | head | body | responseType | responseOptions |
|---|---|---|---|---|
| form | How satisfied are you? | Consider only the last 7 days. | radio | Low;Medium;High |
type,head,body,responseType,responseOptions form,How satisfied are you?,Consider only the last 7 days.,radio,Low;Medium;High
head renders as the question title, body as smaller description text underneath.
| type | title | body | button1 |
|---|---|---|---|
| Instructions | <p>Press <b>Start</b> when ready.</p> | Start |
type,title,body,button1 ,Instructions,<p>Press <b>Start</b> when ready.</p>,Start
No stimFormat, so the trial is an instructions screen: title in the title area, body as HTML in the content area.
| type | head | body | responseType |
|---|---|---|---|
| form | Feedback | Your last response was %response% (RT %rt% ms). | box |
type,head,body,responseType form,Feedback,Your last response was %response% (RT %rt% ms).,box
Variables are substituted before display.
Tips & gotchas
Section titled “Tips & gotchas”- Do not mix up the two text columns:
headis the question itself (the title),bodyis the supporting description under it, not the other way around. - Dynamic list values in
bodywork on form trials but are silently ignored on instructions screens. - On form trials an empty
bodysimply omits the description line; nothing takes its place in the layout.