Columns Reference

Every column you can use in a trial file, documented and verified against how the Testable runtime actually behaves. Each page covers what the column does, its syntax and accepted values, defaults, the columns it works with, examples, and tips.

Find your column in the tables below, or browse the sidebar by topic. Looking for the columns Testable writes into your results files instead? See the Results Reference.

Arrows & Touch

Column	Documentation
leftArrow	leftArrow
rightArrow	rightArrow
topLeft	topLeft
topRight	topRight

Block Rules

Column	Documentation
block	block
repeat	repeat
rules	rules

Buttons

Column	Documentation
button1 … button12	buttonN

Conditional Logic

Column	Documentation
if	if
label	label
staircase	staircase
then	then

Core Trial

Column	Documentation
condition1 … condition4	conditionN
subtest	subtest
test	test
trialNo	trialNo
type	type

Counterbalancing

Column	Documentation
counterPart	counterPart
counterTrial	counterTrial
subjectGroup	subjectGroup

Feedback

Column	Documentation
feedback	feedback
feedbackOptions	feedbackOptions
feedbackTime	feedbackTime
score	score

Fixation

Column	Documentation
fixation	fixation

Flow Control

Column	Documentation
break	break
script	script

Form Basics

Column	Documentation
form	form

Keyboard Responses

Column	Documentation
key	key
keyboard	keyboard
responseOptions	responseOptions

Multiplayer

Column	Documentation
arena	arena
arena_advance	arena_advance
arena_responses	arena_responses
arena_sequence	arena_sequence

Page Text

Column	Documentation
content	content
title	title

Randomisation

Column	Documentation
random	random
randomBlock	randomBlock
stimOrder	stimOrder
trialOrder	trialOrder

Response Collection

Column	Documentation
responseWindow	responseWindow

Selecting & Saving

Column	Documentation
select	select

Sorting

Column	Documentation
sort1 … sort6	sortN

Stimulus Layout

Column	Documentation
stimOptions	stimOptions
stimPos	stimPos
stimSize	stimSize

Stimulus Lists & Formats

Column	Documentation
listOptions	listOptions
stim	stim
stimFormat	stimFormat
stimList	stimList

Stimulus Files

Column	Documentation
audio	audio
mask	mask
stim1 … stim6	stimN
target	target

Styling

Column	Documentation
background	background
bgColor	bgColor
color	color
cursor	cursor
textColor	textColor
textSize	textSize

Survey Response Settings

Column	Documentation
required	required
responsePos	responsePos
responseType	responseType

Survey Response Options

Column	Documentation
responseOptionsRandom	responseOptionsRandom
responseOther	responseOther
responseRows	responseRows
responseRowsRandom	responseRowsRandom

Survey Structure

Column	Documentation
body	body
code	code
head	head
pageBreak	pageBreak
pageName	pageName
separator	separator

Timers & Triggers

Column	Documentation
timer	timer

Timing

Column	Documentation
ISI	ISI
ITI	ITI
presTime	presTime
stimScreens	stimScreens

Trial Text

Column	Documentation
trialText	trialText
trialTextOptions	trialTextOptions
trialTextPos	trialTextPos

Legacy columns

Caution

These columns still work in old experiments but should not be used in new ones. Each page explains what to use instead.

Column	Documentation	Use instead
feedbackCorrect	feedbackCorrect	feedback with feedbackOptions and key scoring instead
feedbackIncorrect	feedbackIncorrect	feedback with feedbackOptions and key scoring instead
fixationStim	fixationStim	fixation instead
presTime2	presTime2	presTime instead: it accepts one presentation time per screen, separated by semicolons
presTimeS2	presTimeS2	presTime instead: it accepts one presentation time per screen, separated by semicolons
randomPick	randomPick	trialOrder sampling specs instead (for example 1: sample 10)
trialGroup	trialGroup	trialOrder specs instead (for example 1: sample 10 difficulty keeps 10 trials per value of difficulty)
waitStimEnd	waitStimEnd	responseWindow instead

What the icons mean

Every column in the sidebar carries an icon for where it works, and columns that work in both places carry both icons: Experiments Surveys & forms

Where each column applies

Some columns only make sense in an experiment, others only in a survey or form, and many work in both.

Column	Topic	Applies to
arena	Multiplayer	Experiments
arena_advance	Multiplayer	Experiments
arena_responses	Multiplayer	Experiments
arena_sequence	Multiplayer	Experiments
audio	Stimulus Files	Experiments
background	Styling	Experiments
bgColor	Styling	Experiments
block	Block Rules	Experiments and surveys
body	Survey Structure	Experiments and surveys
break	Flow Control	Experiments and surveys
button1 … button12	Buttons	Experiments and surveys
code	Survey Structure	Experiments and surveys
color	Styling	Experiments
condition1 … condition4	Core Trial	Experiments and surveys
content	Page Text	Experiments
counterPart	Counterbalancing	Experiments
counterTrial	Counterbalancing	Experiments
cursor	Styling	Experiments
feedback	Feedback	Experiments
feedbackCorrect	Feedback	Experiments
feedbackIncorrect	Feedback	Experiments
feedbackOptions	Feedback	Experiments
feedbackTime	Feedback	Experiments
fixation	Fixation	Experiments
fixationStim	Fixation	Experiments
form	Form Basics	Surveys & forms
head	Survey Structure	Experiments and surveys
if	Conditional Logic	Experiments and surveys
ISI	Timing	Experiments
ITI	Timing	Experiments and surveys
key	Keyboard Responses	Experiments and surveys
keyboard	Keyboard Responses	Experiments
label	Conditional Logic	Experiments and surveys
leftArrow	Arrows & Touch	Experiments
listOptions	Stimulus Lists & Formats	Experiments
mask	Stimulus Files	Experiments
pageBreak	Survey Structure	Surveys & forms
pageName	Survey Structure	Surveys & forms
presTime	Timing	Experiments
presTime2	Timing	Experiments
presTimeS2	Timing	Experiments
random	Randomisation	Experiments and surveys
randomBlock	Randomisation	Experiments and surveys
randomPick	Randomisation	Experiments and surveys
repeat	Block Rules	Experiments and surveys
required	Survey Response Settings	Experiments and surveys
responseOptions	Keyboard Responses	Experiments and surveys
responseOptionsRandom	Survey Response Options	Surveys & forms
responseOther	Survey Response Options	Surveys & forms
responsePos	Survey Response Settings	Experiments
responseRows	Survey Response Options	Experiments and surveys
responseRowsRandom	Survey Response Options	Surveys & forms
responseType	Survey Response Settings	Experiments and surveys
responseWindow	Response Collection	Experiments and surveys
rightArrow	Arrows & Touch	Experiments
rules	Block Rules	Experiments and surveys
score	Feedback	Surveys & forms
script	Flow Control	Experiments and surveys
select	Selecting & Saving	Experiments
separator	Survey Structure	Surveys & forms
sort1 … sort6	Sorting	Experiments
staircase	Conditional Logic	Experiments
stim	Stimulus Lists & Formats	Experiments and surveys
stim1 … stim6	Stimulus Files	Experiments and surveys
stimFormat	Stimulus Lists & Formats	Experiments and surveys
stimList	Stimulus Lists & Formats	Experiments and surveys
stimOptions	Stimulus Layout	Experiments and surveys
stimOrder	Randomisation	Experiments
stimPos	Stimulus Layout	Experiments
stimScreens	Timing	Experiments
stimSize	Stimulus Layout	Experiments
subjectGroup	Counterbalancing	Experiments and surveys
subtest	Core Trial	Experiments and surveys
target	Stimulus Files	Experiments
test	Core Trial	Experiments and surveys
textColor	Styling	Experiments
textSize	Styling	Experiments and surveys
then	Conditional Logic	Experiments and surveys
timer	Timers & Triggers	Experiments and surveys
title	Page Text	Experiments
topLeft	Arrows & Touch	Experiments
topRight	Arrows & Touch	Experiments
trialGroup	Randomisation	Experiments and surveys
trialNo	Core Trial	Experiments and surveys
trialOrder	Randomisation	Experiments and surveys
trialText	Trial Text	Experiments
trialTextOptions	Trial Text	Experiments
trialTextPos	Trial Text	Experiments
type	Core Trial	Experiments and surveys
waitStimEnd	Response Collection	Experiments