Text Component

This component can be used to present text to the participant, either instructions or stimuli.


Everything in a PsychoPy® experiment needs a unique name. The name should contain only letters, numbers and underscores (no punctuation marks or spaces).

start :

The time that the stimulus should first appear. See Defining the onset/duration of components for details.

stop :

The duration for which the stimulus is presented. See Defining the onset/duration of components for details.


Text to be shown


How should the stimulus look? Colour, borders, etc.

foreground color :

See Color spaces

foreground color spacergb, dkl or lms

See Color spaces

opacity :

Vary the transparency, from 0.0 = invisible to 1.0 = opaque


How should the stimulus be laid out? Padding, margins, size, position, etc.

flip :

Whether to mirror-reverse the text: ‘horiz’ for left-right mirroring, ‘vert’ for up-down mirroring. The flip can be set dynamically on a per-frame basis by using a variable, e.g., $mirror, as defined in a code component or conditions file and set to either ‘horiz’ or ‘vert’.


The orientation of the stimulus in degrees.


The position of the centre of the stimulus, in the units specified by the stimulus or window

spatial unitsdeg, cm, pix, norm, or inherit from window

See Units for the window and stimuli

wrap widthcode

How many characters in should text be wrapped at?


Formatting text


What font should the text be set in? Must be the name of a font installed on your computer

language styleLTR, RTL, Arabic

Should text be laid out from left to right (LTR), from right to left (RTL), or laid out like Arabic script?

letter heightinteger or float

The height of the characters in the given units of the stimulus/window. Note that nearly all actual letters will occupy a smaller space than this, depending on font, character, presence of accents etc. The width of the letters is determined by the aspect ratio of the font.

See also

API reference for TextStim

Back to top