Tags

Tags are used to define and modify widgets, questions and variables, both visible and hidden, that make up a survey. While some tags are required for widgets to be fully-defined, e.g., using the type tag to specify a question type, others are optional, but still necessary for the widget to function as desired. Tags may specify details such as instructions, acceptable answer ranges for open-ended questions, validations, "decline to answer" responses, text field sizes, and more.

Below you will find a list of many of our most commonly used tags, listed alphabetically, with links to articles for additional information. Some links may include aliases, abbreviated names that can be substituted for the full name; any aliases will be listed in parentheses after the tag name. We have also included a "For use with" column that specifies which widget types they can be applied to.

To jump ahead to a specific letter, use the table of contents to the right.

A

Tag	For use with...	Description
accept	`type: upload`	Use to specify certain file types that can be uploaded.
accessibility	`app config`	For use with the Modern theme; provides additional functionalities to simple question and table types to improve the survey experience for respondents with disabilities.
add rule	CheatSweep	Used to add a new, custom rule to CheatSweep or to disable current rules.
allow country	CheatSweep	Specifies a country (or countries) for which IP addresses are allowed for respondents; respondents not matching that country will be immediately termed.
allow dup	CheatSweep	Allows multiple responses from a single person. By default, people that attempt multiple responses will be termed and coded as "duplicate."
allow reads from	`app config`	Used along with the `get_answer` method to import data from other respondent records and/or surveys that reside on the same server.
alphabetize	setlists, inline lists	Alphabetizes a list and only goes from A to Z; can be used with the `anchor` tag.
alt color	radio and checkbox tables	Used to alternate row colors.
alt label	questions, tables, and variables	Creates an alternate question ID in exported files.
always	`send email`	Specifies whether an e-mail message is sent every time a respondent views a page that triggers the send command for that message.
anchor	lists	Anchors an option in its listed position of a randomized list. Frequently this is used to anchor an item at the end of a list.
anchor autoother	`set defaults`, individual questions	Specifies that autoother options used in questions that include either `randomize: y` or the `order` tag will be anchored in their list positions.
anchor exclusive	`set defaults`	Specifies that all options identified as "exclusive" via the `exclusive` tag or decorator would be anchored in their position in a randomized list.
apply if	quotas, closed-ended `selectby` variables (ex: `type: coded multi select/type: coded single select`), closed-ended questions	Used for closed-end variables or quotas which do not have exhaustive buckets for all respondent groups and the respondent should not punch that variable/quota.
attach	`send email`	Specifies a file attachment for an e-mail message.
audience sheet	audience quotas	Triggers the platform to place a quota in the Audience Quotas applet instead of the Quotas applet. It should be placed on a quota variable created with `type: quota`.
audience type	audience quotas	Organizes quotas into groups within the Audience Quotas applet. The tag is used in conjunction with the 'audtype' parameter.
autocalc	numeric questions and tables, or text variables and tables with `datatype: number`, `datatype: integer`, `datatype: whole`	Used to update a text field dynamically based on a mathematical expression.
autocode	radio and checkbox questions	Automatically sets an answer for a closed-end question based on a previous question's answer(s) with minimal code, using conditional statements to establish the logic of the autocoding.
autocomplete (ac)	text questions	Used to create an interactive menu of suggested text matches, which updates as the respondent types into a text field.
autoother	lists	Used on a list with underscores for the length of the text box (`autoother: y` as a decorator can also be used).
autopage (ap)	any question/variable type, `set defaults`	Determines if a page break will be automatically inserted before the question it is applied to.
autoredirect	`app config`	Part of a system to redirect respondents to the appropriate web pages after a finishing status (C, T, Q, B, etc.).
autosubmit	`set defaults`, `page template data`	Provides a way to automatically submit data and proceed to the next page when a response to a radio question is clicked. For mobile-friendly themes (Flex, Device Diverse), this is built in.
autotranslate	`app config`	Leverages machine translations to automatically translate responses not in the primary programming language.

B

Tag	For use with...	Description
back button (backbtn)	`set defaults`, on individual questions	A button respondents can use to navigate backwards through the survey; the SP can change look and behavior in Modern, Device Diverse, or Flex themes.
back button image (backbtn img)	`set defaults`	Specifies an image to use in place of the default back button image. Accepts a URL path for the custom image, or a Perl expression to evaluate.
back button text	`set defaults`	Replaces the default back button with text.
balanceby	radio and checkbox questions, `type: quotas`	Used in conjunction with `selectby: balance` to a closed-end question to instruct the software to balance the assignment of a value/bucket to the question by a nesting of the questions following the tag. The variables used to define the `balanceby` must be radio questions/variables or single-select quotas.
bare	blocks, `set conditioned text` , `show conditioned text`	Simplifies the HTML generated by content in blocks and conditioned text widgets. This is useful in situations where the HTML created by these widgets is having undesirable effects on the survey page, such as when using the `cell` tag or custom scripts.
bcc	`send email`	Specifies an e-mail address, or a comma-separated list of e-mail addresses, that should receive a blind copy (bcc) of the outgoing e-mail message.
bcc name	`send email`	Specifies a descriptive name to insert in place of the blind copy (bcc) address for an outgoing e-mail message.
break headings	scale questions, slider and radio slider questions	Disables line breaks in headings.
build quotas from	uszip5 questions	Create quotas from hidden variables automatically by placing the tag directly on the question.

C

Tag	For use with...	Description
card height	card sorts	Specifies the height of the cards in pixels.
card id separator	card sorts	Specifies the character inserted between the card sort ID and the row ID.
card margin	card sorts	Creates padding between contents of cards and card border in pixels.
card order	card sorts	Specifies the order to apply to the cards. This overrides any previous ordering on the original list or sheet.
card order from	card sorts	Uses the order from a previous widget and applies it to the list referenced at a `cards from` tag.
card style	card sorts	Specifies the custom CSS for card styling.
card width	card sorts	Specifies the width of the card in pixels.
cards from	card sorts	Specifies the list which is used to create the cards.
cardtype	card sorts	Specifies the card sort type: 'place' or 'sort'.
cc	`send email`	Specifies an e-mail address, or a comma-separated list of e-mail addresses, that should receive a copy (cc) of the outgoing e-mail message.
cc name	`send email`	Specifies a descriptive name to insert in place of the copy (cc) address for an outgoing e-mail message.
cell	tables	Allows for targeting table options and replacing them with text, images, or hiding them all together.
cell align	text tables	Specifies where within table cells text input boxes are aligned. Valid only on text tables.
center heading	tables	Creates a center heading text. This tag allows for the vertical pipe up to two times, providing a maximum of three separate texts across the center of the scale, for example: `center heading: left center text \| center \| right center text`.
chapter	on any widget	Sets the chapter of the survey for reporting tree hierarchy.
charset	`app config`, `send email`	Sets the text encoding system to be used.
cheatsweep entry calc (cs entry calc)	CheatSweep	Accepts 'y' and 'n'; can be added to individual variables, or groups of variables, to allow panel-specific variables to still be run/punched before a Duplicate respondent is sent out of the survey.
click balance quota (cbq)	`type: quotas`, single select widgets	Accepts 'y' and 'n'; allows SPs to create quotas for click balancing purposes. A click balance quota is based on all incoming traffic, not just completes, and is used for representative sampling.
click balance quota apply if (cbq apply if)	`app config`, `click balance quotas`	Specifies a condition for which, if "true" for a given respondent, then they should be included in a click balance quota's group for which they qualify.
click balance quota base (cbq base)	`app config`, click balance quotas	Specifies the quota base (condition) applied to the click balance quotas, overriding the default values.
col id	tables	Assigns an alternate ID to inline columns; for example, `col id: A`. In absence of this tag, the columns default to the labels 1, 2, etc. in sequential order.
col id separator	tables	Specifies a separator character(s) inserted between the table ID and column ID. If not specified, defaults to 'C'.
col order	radio and checkbox tables	Specifies the order of columns in a table.
col order from	tables	Uses the order from a previous widget and applies it to the list referenced at a `cols from` tag.
col separator	tables	Accepts 'y' and 'n'; adds spacing between columns when set to 'y' to more clearly define the columns and options.
col width	text tables	Specifies the number of pixels wide a column will be when displayed. This can be used in text tables and any table using a `cols from` tag.
collection punch summary	checkbox questions and coded multiple select variables; references a list with collection header decorators or collection headers	This tag creates a variable that will indicate all of the collections that had at least one of their child elements selected in this question. It creates summary variables to "roll up" or summarize data selected in large lists with multiple collections.
cols from columns	radio and checkbox tables, vscale tables	Used to create table columns from a list or sheet. Used to create an inline list of column options.
column group header	tables	Accepts 'y' and 'n'; defaults to 'n'. Enables the group headings from a list – e.g., '_A. Group name here'.
column group text	tables	Locally defines the group collection header across the columns instead of pulling it from a list (e.g., `column group text: Building Materials)`. Must be paired with `column group header: y` .
column validation	tables	Applies a validation individually to every column of a table. This tag is used with the `message` decorator.
column validation condition (colval)	tables	Applies a validation individually to every column of a table. This tag is used with the `column validation message` tag.
column validation message (colmsg)	tables	Message shown to respondent if the `column validation` is not met.
columns	radio and checkbox questions and tables	Controls how many different vertical columns of answer options should be displayed.
condition	`send email`, blocks, new page, groups	Specifies logic that must be true before the e-mail will be sent.
continue button (contbtn)	`set defaults`	A button respondents can use to navigate forwards through the survey; the SP can change look and behavior in Modern, Device Diverse, or Flex themes. Not needed if autopage is set to 'n'.
continue button image (contbtn img)	`set defaults`	Specifies an image to use in place of the default continue button image. Accepts a URL path for the custom image or a Perl expression to evaluate.
continue button text	`set defaults`	Replaces the default continue button with text.
create closed	text and numeric questions	Apply directly to an open-ended question (ex: age input) to create a closed-ended variable based off a set list.
create quota	radio and checkbox questions	Add to a question and it will use the specified value as a question ID to create a derived quota variable.
create timers	`start group`, `define chapters`, `set defaults`	Creates a variable that tracks the amount of time elapsed within specific sections of a survey.
crosslist id separator	crosslists	Allows the user to specify how to separate the IDs in the resulting crosslist options in the reports and database; e.g., `crosslist id separator:` would result in a displayed option ID such as '13' instead of the default '1_3'.
crosslist text separator	crosslists	Allows the user to specify how to separate the text in the resulting crosslist options in the reports and database; e.g., `crosslist text separator: ~` would result in a displayed option text such as 'Male ~ 45-54' instead of the default 'Male, 45-54.'
crosslist tile	crosslists	In the case of a quota widget utilizing a crosslist, the resulting tile on the Quota Manager will be a crosslist quota. To disable this functionality and have the tile display all options as a typical quota, include this tag and set the input to 'n'.
css	any question or table	Customizes the look and feel of a specific question/table.
cvalue	`type: coded number`, `selectby: calculate`, `listWhich`, and more	Used on a question or variable to calculate and set a value. The value is set when the parent page is submitted. The tag input can contain any logical statement or Perl expression, and it uses the same formatting and syntax rules as standard Perl scripts.

D

Tag	For use with...	Description
datatype	text, numeric, and date questions	Validates a respondent's input to open-ended questions; an invalid entry results in a failed submission page with an appropriate error message.
decline to answer (dta)	all question types	"Decline to answer" options (a.k.a., DTAs) can be used with any kind of question or table to add a single checkbox above or below the variable in order to disable the question inputs. This is useful for allowing an opt-out option for a question, or an entire table as a whole.
default date	date questions	When the calendar control appears, indicates the date the calendar begins with. A properly formatted date or variable that contains a string of a date can be used as the tag's value.
defer if none	quotas	To delay the termination of a respondent who does not qualify for any options at a quota.
defer if over	quotas	To delay the termination of a respondent that qualifies for a quota option which has already reached its cap.
defer term	`app config`	Allows respondents meeting a `term if` or `set term` condition to continue to a specified point in the survey before their interview is ended.
derive from	sheets	Used with `matchto` to pull data from specific fields in a sheet.
desc	all question and table types asides from ranking questions	Add to a question to provide alternative question text in reports.
design from	MaxDiff	Specifies the name of the sheet containing the MaxDiff design.
disable rules	CheatSweep	Disables a rule, excluding it from the CheatSweep calculation.
disallow country	CheatSweep	Specifies a country (or countries) for which IP addresses are not allowed for respondents; respondents matching the specified country codes are immediately termed. Requires country codes for input. Multiple countries may be specified in a comma-separated list.
dta before	any question with a decline to answer (DTA) option	Accepts 'y' and 'n'; setting to 'y' causes the DTA option(s) to be displayed before the question/table to which it is attached. Defaults to 'n' (displaying after the question/table).
dta col	text, integer, and number tables	Intended for tables with text input (integer, number, etc.) to create a DTA column.
dta row	text, integer, and number tables	Intended for tables with text input (integer, number, etc.) to create a DTA row.
dvalue	radio questions and tables, checkbox questions and tables, slider and radio slider questions, text questions with `invisible: y`	Sets a value to a question or variable. It populates on page load. In the case of visible, respondent-facing questions, respondents can accept the default response and proceed to the next page, or they can choose a different response.
dynamic options	radio, checkbox, and pulldown questions	Narrows the selectable options of a question based on the response of another question, or trigger.

E

Tag	For use with...	Description
edit completes	`app config`	Allows editing of records with Complete statuses.
editable by	questions, variables, quotas	For use with IntelliBuilder; elements including this can only be edited or copied by Survey Creators with the specified role ('advanced' or 'expert').
enable when	any question type	Used to enable or disable a question when as specified condition is true.
encrypt	text questions	Encrypts data collected by its parent widget, valid only on open-end fields. Data is only visible to users with Superuser or higher system permissions.
end date	`type: date`	Indicates an end date for the date entry.
end table	tables created via `start table` widget	Lets the program know the code for the table has been completed. Must be paired with the `start table` tag.
exclusive	multiselect (checkbox) questions, tables, and variables	Designates when options or collections of options should not be selectable with other options.
expected country	CheatSweep	Specifies a country (or countries) for which IP addresses are allowed for respondents. Requires country codes for input. Multiple countries may be specified in a comma-separated list.
explain	lists, images, question text, `set text`	Adds an "info" icon that displays a tooltip to respondents when hovered over or tapped.
export as non-verticalized/export as verticalized	most questions/variables	Switches a question's classification in Verticalized (Tableau) reports, allowing it to be exported in a file outside of its typical designation.

F

Tag	For use with...	Description
fade in	all question types	Hides a question widget when the page loads, and fades it in after a period of time. The purpose of this tag is to encourage respondents to read the content of the page prior to answering the question.
fade in delay	all question types	Customizes how long to wait before the fade in begins. If undefined, the default value is 1000 ms (1 second).
fade in duration	all question types	Customizes how long the fade should take to complete. If undefined, the default duration is 1000 ms.
fail if	all question types	Creates an attention check variable to use in evaluating data.
feedback	`app config`	Enables/disables per page respondent feedback.
first day	`type: date`	Specifies which day of the week the calendar begins on; '0' = Sunday (default), '1' = Monday, etc..
flat col order	tables	Suppresses the order for columns defined with the `cols from` tag in a multicolumn table if a random order was previously defined.
flat order	set lists	Directly modifies option ordering in a list built from multiple collections. The hierarchy of collections is "flattened," so each individual list element can be directly referenced.
flat row order	tables	Suppresses the order for rows defined with the `rows from` tag in a multicolumn table if a random order was previously defined.
focus	`set defaults`, `new page`	Disables the indicator many browsers use on a first input field when displaying a survey question on page load. This generally looks like a box or dashed line around the selection field.
footnote	any question type	Allows text, images, or other content to be placed below or after the question.
freeform	blocks	Used when a block should not be reporting into a summary or rollup tile (e.g., response options are different per iteration of the question).
from	`send email`	Specifies the source (from) e-mail address, or a comma-separated list of e-mail addresses, for an outgoing e-mail message.
from name	`send email`	Specifies a descriptive name to insert in place of the source (from) address for an outgoing e-mail message.

G/H

Tag	For use with...	Description
goto	questions or tables	Routes respondents to a question, labeled group, or page.
group by	CheatSweep	Specifies a pre-defined variable to use to sweep respondents within the groups they have been assigned, as opposed to sweeping all respondent data together.
header layout	card sorts	Specifies the location of the target header. Can be 'left' or 'top' (default).
header style	card sorts	Specifies custom CSS for styling the target header.
heading / headings	MaxDiff, scaled radio questions, tables	Adds headings across the top of a scaled radio question or a table.
height	slider and radio slider questions	Used with `vertical: y`; specifies the height of the slider widget in either pixels or as a percent (with percent sign); integer input.
heredoc (here document)	blocks, `set text`, `show text`, `cvalue`, table rows, and more	Allows survey code to span multiple lines to improve functionality, clarity of code, or access of code.
hide language picker	`app config`	Specifies to hide the language picker on survey pages.
hscale	radio questions	Converts a radio question into a horizontal scale which uses headings.
html	anywhere the `text` tag can be used, free text, and text widgets	Substitute in place of `text` tag to format pages, insert special characters, create tables, and more.
html file	`send email`	Specifies an HTML file that contains the body of the e-mail message you want to send. The file must be stored in the _s directory. The file name must then be supplied here without a path.

I

Tag	For use with...	Description
ib collapse group	survey-admin type variables	Allows default collapsing of a group in the IntelliBuilder editor while in the Builder view.
if blank	number or integer questions or tables	Used to set a value to open-ended fields that are left unfilled, but have been seen by the respondent.
if none	`type: quotas`	Defines where a respondent should be routed to if they have a "Terminate" status.
if not set	number or integer questions or tables	Used to set a value to open-ended fields that are left unfilled, even those that have not been seen by the respondent.
if over	`type: quotas`	Defines where a respondent should be routed to if they have an "Over quota" status.
image alt text	`show image`	Functions similarly to the `text` decorator and specifies alternate text to display in place of the image if it cannot be displayed.
image max height	`show image`	Specifies the maximum displayed height of the image in pixels.
image max width	`show image`	Specifies the maximum displayed width of the image in pixels.
image placement	`show image`	Specifies where the image should be displayed in relation to the option text.
inactive lockout	`app config`	Controls the re-entry of respondents who have become "Inactive."
inactive timeout	`app config`	Sets the period of time that must elapse for an unresponsive In-progress (P) respondent to become an Inactive (N) respondent.
inline	decline to answer, blocks, groups	Causes the DTA option to be displayed alongside the question's options, rather than separate from them.
instructions (instruct)	any question type	Attaches instructions to a question without showing them in the reports. Instructions are helpful for clarifying complex questions.
intro	advanced tables, `create rank`	Specifies question's introduction text; not for simple tables.
invisible	any question type	Set to 'y' to hide a question from respondents.
item chapter	ranking	The chapter where the ranking widget's item fields appear.
item id separator	ranking	Specifies a different character to separate widget ID from item option ID in item variable name.
item order	ranking	Specifies the ordering of the elements in the list specified.
items from	ranking	Specifies the list of items to be ranked.

J/K

L

Tag	For use with...	Description
label above / labels above	slider questions	Accepts 'y' and 'n'; set to 'y' to display the label steps above the slider. Defaults to 'n' (displaying label steps below slider).
label hide	slider questions, star questions	Accepts 'y' and 'n'; if set to 'y', will hide the values displayed within the stars/hide the labels of the slider. Defaults to 'n'.
label step / labels step	slider questions	Defines the delta (increments) at which points the slider labels are rendered; requires positive, non-zero integer input. Must be used with the `step` tag.
language	`send: email`	Specifies the language that the e-mail was written in.
language picker (lang picker)	`type: radio`	Allows respondents to select their survey language before the survey.
layout	card sorts, MaxDiffs	Describes the visual relationship between the card parent area and target areas. For MaxDiffs, this describes the column ordering for how the exercise is displayed.
leading q	questions	Accepts 'y' and 'n'; defaults to 'y'. If defined with a 'n' input, this tag will drop the leading Q from the question label.
left heading	tables	Creates a left heading text and places the defined text above the anchor to the left of the scale. If used with the `left offset heading` tag, this tag places the text above the left side of the scale, but to the right of the `left offset heading` text. This cannot be combined with the standard `headings` tag.
left offset heading	tables	Creates a distinct, left heading text and places the defined text above the anchor to the extreme left of the scale. This cannot be combined with the standard `headings` tag.
left to right	radio and checkbox questions	Specifies to show a long list of options from left to right instead of top to bottom.
lock	routing variables, quotas, can be used on any question type	Prevents respondents from going back to previous survey questions and changing responses which can lead to changed group designations.

M

Tag	For use with...	Description
mark as (mark)	any question type	Shortcut for referencing variables within conditional statements for closed-end options. As a tag, it requires a variable name followed by a qualifying condition.
markdown	free text	Substitute in place of a `text` tag to format using Wiki markdown syntax.
matchto	sheets	Use on the question containing the value to check against a sheet. Used with `derivefrom`.
max	`step` tag, sliders and slider tables	Specifies the maximum accepted value for a response.
max cap message	`app config`	Specifies a message (other than the default) to display to respondents when a survey's max capacity is exceeded.
maxcards	card sorts	Sets the maximum number of cards accepted in each target.
maxchecked	checkbox questions and tables	Specifies the maximum number of responses that can be selected in a question or variable.
maxdiff mode	`set defaults`	Specifies a global display setting for all MaxDiff exercises in a survey unless a widget locally contains a `mode` tag to override the `maxdiff mode` setting.
maxgroups	coded multiple select variables, `type: quotas`	Specifies the maximum number of options or quota groups a respondent may be assigned to, provided the respondent meets qualifying condition criteria and in the case of quota the bucket is not full.
maxlength (maxlen)	text, numeric, and textbox questions	Specifies the maximum number of characters a respondent can enter in a text field.
message	`validation` and `end survey`	Customizes the standard message displayed when a question cannot be submitted due to an error. Customizes the final message a respondent sees before exiting the survey.
metric	radio and integer questions, radio and checkbox tables, nps questions	Adds custom metrics to Crosstab reports.
min	text, sliders, and slider tables	Specifies the minimum accepted value for a response.
min cards	card sorts	Sets the minimum number of cards required in each target.
minchecked	checkbox questions and tables	Specifies the minimum number of responses that can be selected in a question or variable.
minlength (minlen)	text, numeric, and textbox questions	Specifies the minimum number of characters a respondent can enter in a text field.
mode	tables, MaxDiffs	Useful for mobile-friendly themes to alter the default display style of a single widget.
most/least	MaxDiffs	Specifies the heading/button text for the "best" and "worst" columns, respectively.

N

Tag	For use with...	Description
named timer	groups	Establishes a timer name, e.g., "Screener_Time."
new page	between survey questions or variables if needed	Use to manually insert page breaks between survey content. By default, autopage is enabled, which inserts page breaks automatically.
no animation	card sorts	Toggles animation for card movement.
no start area	card sorts	Toggles the presence of a parent area for ranking card sorts.
notice	MaxDiffs	Specifies the text to display in an in-window notification to the respondent, sometimes called a "boost" or encouragement message.
number format	number and integer questions, and text questions with `datatype: whole`	Specifies formatting for numeric responses, such as grouping separators (e.g., commas in the United States) or the number of allowed decimal places.
number locale	number and integer questions, and text questions with `datatype: whole`	Can be included with the `number format` tag on a numeric response question to display the appropriate number separators and/or currency symbols for locales outside of the US.
numchecked	checkbox and listbox questions	Accepts various operators or a range of options when asked to allow a specific quantity of responses a respondent can select.

O

Tag	For use with...	Description
onload	`cvalue`, `goto`, `send email`, `set value`	Execute the widget function on page load ('y'), rather than page submit ('n').
option images	radio and checkbox questions	To trigger the display of all options in the list, include on the question widget.
option image alt text	`option images`	Functions similarly to the `text` decorator and specifies alternate text to display in place of the image if it cannot be displayed.
option image max height	`option images`	Specifies the maximum displayed height of the image in pixels.
option image max width	`option images`	Specifies the maximum displayed width of the image in pixels.
option image placement	`option images`	Specifies where the image should be displayed in relation to the option text.
opt order from	tables	Uses the order from a previous widget and applies it to the list referenced at a `opts from` tag.
opts from	tables, questions, quotas	Specifies the list, sheet, or question to pull from to create the answer options.
opt width	any question with a columns tag	Use to specify the width of option columns when a question has multiple columns of options due to use of columns tag.
oq text	`quotas: y`	Specifies the description that appears in reports for quotas generated when using.
order	sheets, lists, groups	Arrange collections of elements (options, rows, columns, questions, sheets, etc.).
order from	any question type	Uses the order from a previous widget and applies it to a question or table's answer options.

P

Tag	For use with...	Description
page css	any question or table	Customizes the look and feel of a survey page, targeting all questions or tables on the page.
page every	large tables	Display a set number of rows on each page.
page by group	large tables	For finer control over exactly which rows should be shown on which page.
page not found	`app config`	Specifies the question or page which a respondent who lands on a non-existent page will be routed to. If omitted, respondents are routed to the first survey page.
page template data	`set defaults`	Customizes the behavior of the continue and back buttons in mobile-friendly themes such as Flex, Modern, and Device Diverse.
panel sheet	`app config`	Specifies which sheet to pull panel IDs and information from and is followed by a local or system sheet reference.
parent	`define chapters`	Used for adding custom sub-chapters to existing parent system chapters.
parent height	card sorts	Specifies the height in pixels of the parent area where cards start.
parent style	card sorts	Allows user to add custom CSS for styling the parent area.
parent width	card sorts	Specifies the width of parent area in pixels.
pass if	any question type	Use to create an attention check variable that can be used in evaluating data for quality.
placeholder	used with autoother	Specifies default text which appears in the field on page load. The text disappears when the respondent begins typing in the box.
plaintext	`send email`	Specifies to the survey software that a send email widget will be used.
postfix	numeric, text, text table, or slider questions	Specifies text or a symbol to be shown after the respondent text field.
poweredby	`app config`	Changes the "Powered by IntelliSurvey" footer message/link.
poweredby_url	`app config`	Changes the URL for the "Powered by" footer link.
preface	any question type	Allows text, images, or other content to be placed above a question.
prefix	text, text table or slider questions	Specifies text or a symbol to be shown before the respondent text field.
preserve case	`set defaults`, any question/variable	Accepts 'y' and 'n'; defaults to false ('n'). When set to 'y', specifies that the question ID remains in the exact format as it is written in the source code.
present as	ranking	Changes the desired output style from pulldowns to buttons in standard themes.
progress	group widgets, new page	Set to 'n' if pages should not be included within the calculation for the progress bar (i.e. in blocks) to make it more accurate.
progressbar	`app config`, MaxDiff	Accepts 'y' and 'n'; if set to 'y', then will display a progress bar that increments as the respondent gets further into the exercise.
prompt	pulldowns, `type: stars`	Displays addition text on screen which can be used to provide additional instructions or used as a visual indicator.

Q

Tag	For use with...	Description
qualified value	`type: quotas`	Specifies the option that should be punched, instead of relying on `selectby` to evaluate option conditions or counts. It can be thought of as a `cvalue` for quotas.
qualify if	any question type	Defines conditional logic for qualifying respondents based on their answers.
question mode	`set defaults`	Specifies a global display setting for all questions in a survey unless a widget locally contains a `mode` tag to override the `question mode` setting.
quotabase	`type: quotas`	Specifies the criteria that must be met to increment counts for this quota.
quota chapter	`quotas: y`	Specifies the chapter in which the derived quota variable should appear.
quota suffix	`quotas: y`	Overrides the default "_QUOTA" suffix appended to the quota variables created.
quota tracking variable	`type: quotas`	Used to specify the name of a variable to use to store over quota punches.
quotas	radio and checkbox questions	Add to a regular question to create derived quota fields.

R

Tag	For use with...	Description
randomize	set lists, inline lists	Accepts 'y' and 'n'; randomizes lists of options.
randomize split (randsplit)	contratext table	Accepts 'y' and 'n'; setting to 'y' allows for randomizing which elements in a row are shown on the left or right - A \| B or B \| A.
range	integer and number questions, text questions with `datatype: whole`	Specifies the accepted response range.
rank	ranking questions	Specifies the number of ranks that can be assigned.
rank id separator	ranking questions	Specifies a different character to separate widget ID from rank code in derived variable name.
ranking chapter	ranking questions	Specifies the chapter where the derived RANK variables appear.
ranking desc	ranking questions	Specifies the iterative description which appears for each rank as the rows in the RANK summary tile.
rank message	ranking questions	Defines the message to display to respondents they do not correctly answer the question.
ranks	ranking questions	Used to specify an inline list of alternative ranks instead of the default numeric rank assignments. Must include heredoc.
ranks desc	ranking questions	Specifies the title for the derived RANK summary tile.
ranks from	ranking questions	Specifies where the rank list is being called from.
raw scores	MaxDiffs	Accepts 'y' and 'n' ; if set to 'y', raw scores are included in the output when scoring. Defaults to 'n'.
redirect	`end survey`	Specifies a web address where the browser should be redirected when a respondent reaches the end of a survey.
remove	CheatSweep	Sets a percentage for which respondents should be removed from the data. An input of 'N%' indicates the highest N% of csp scores should be removed.
%% renderif (%% if)	blocks	Provides logic that controls whether to render the contents of a block when the condition for the iteration is met.
repeat header	tables	Defines how to repeat table headers. This is helpful in cases where scrolling causes the headers at the top of the table to be hidden. The most common usage is to establish the number to repeat every Nth row.
repeat sweep	CheatSweep	Accepts 'y' and 'n'; setting `repeat sweep` to 'n' prevents earlier scored respondents from being reclassified (from F to C, or C to F) due to later results.
report placement	reporting only variables	Changes the variable's location in the reporting field tree, which is helpful when these variables are added after the survey has collected data. Accepts 'before', 'after', and 'here' as input values.
reporting only	coded single select, coded multiple select, coded number	Creates a hidden variable that uses less system resources to retrieve data in real-time. These reporting variables cannot be used in conditional survey logic.
require js	`app config`	Toggles JavaScript requirement on and off; if 'true' the survey will show an error message if JavaScript is disabled.
required	any question, table, or `set defaults`	Use to control whether a question must be answered before the respondent can advance to the next page.
restartonpage	`app config`	Specifies the page upon which inactive respondents will continue if they return to a survey.
reveal rows	tables	Specifies the initial number of visible rows. Once the last visible row is answered, each new row dynamically appears.
reveal rows id	tables	Controls which rows are affected by the reveal rows tag, e.g., reveal `rows id: 971,972,973`.
right heading	tables	Creates a right heading text and places the defined text above the anchor to the right of the scale. If used with the `right offset heading` tag, this tag places the text above the right side of the scale, but to the left of the `right offset heading` text. This cannot be combined with the standard `headings` tag.
right offset heading	tables	Creates a distinct, right heading text and places the defined text above the anchor to the extreme right of the scale. This cannot be combined with the standard `headings` tag.
rollup	blocks	Explicitly stops the build of the rollup (summary) variable. May be necessary to include when questions in a block have variations in options or question types.
row heading align	tables	Changes the default alignment ('center') of the collection headers used in a list of row items. Specify 'right' or 'left'.
row id separator	tables	Specifies a separator character(s) inserted between the table ID and row ID. If not specified, defaults to 'R'.
row order	tables	Specifies the order of rows in a table.
row order from	tables	Uses the order from a previous widget and applies it to the list referenced at a `rows from` tag.
row punch summary	tables	Creates a summary variable for tables; not valid for vscale tables.
row validation	tables	Applies a validation individually to every row of a table. This tag is used with the `message` decorator.
row validation condition (rowval)	tables	Applies a validation individually to every row of a table. This tag is used with the `row validation message` tag.
row validation message (rowmsg)	tables	Message shown to respondent if the `row validation` is not met.
rows rows from	tables	Used to create an inline list of row options. Used to create table rows from a list or sheet.

S

Tag	For use with...	Description
sct message	numeric input tables	Used with `show column total`; defines a custom error message if the respondent does not answer correctly.
sct size	numeric input tables	Used with `show column total`; defines the size of the field (in ems) that displays the total.
sct text	numeric input tables	Used with `show column total`; defines custom text for the "total" row text. The default text is 'Total'.
sct total	numeric input tables	Used with `show column total`; defines and validates the desired total value of all rows. This can be a number, a range, or a logical statement.
seeking value	CheatSweep	Allows users to include condition logic referencing a specific question (or series of questions) to flag respondents who might be attempting to qualify for a survey when they shouldn't.
selectall	checkbox questions	Specifies to automatically select all of the other checkbox response options in a question by checking the "select all" option. This is useful for creating an "All of the above" type option in a checkbox question.
selectby	closed-end questions	Automatically assigns one or more values to closed-ended variables. The selectby method determines how the selection is made.
series	any widget where regular options can be directly placed	Automatically generates numeric or alphabetical sequential list options within a specified range of values or letters. Can only be used in place of the `optsfrom` listcall tag and does not support `text` decorators.
set conditioned text (set ct)	text	Creates content that can be inserted, or piped, repeatedly throughout the survey.
set order	MaxDiffs	Defines the sets' displayed order in a MaxDiff.
set text	text	Creates content that can be inserted, or piped, repeatedly throughout the survey.
show column total (sct)	numeric input tables	Creates a running total of all answers in a given column. Adds a 'Total' row to the bottom of tables which contains the sum of all other rows.
show continue	`embed video`, `type: video`	Specifies the delay time (in seconds) before the continue button appears on screen when a video is playing.
show conditioned text (show ct)	text	Displays content once, where it's placed in the survey.
show if	any question	Used to dynamically display questions, tables, or text when a specified condition is true.
show image	questions or tables	Attach an image to a question's text; specify which image to display.
show row image	tables	Triggers the display of images alongside table rows.
show rows	mobile-friendly theme tables	Forces a given number of rows to display, accepts a whole number or 'all'. Default is to show three rows at one time.
show row tag	tables	Controls the visibility of table row numbers, which are hidden by default.
show tag	questions	Controls the visibility of question and table IDs, which are hidden by default.
show text	text	Displays content once, where it's placed in the survey.
sigil	blocks	Substitute a different character for '%' symbol to identify substitutions. Must be used in nested blocks (blocks within blocks).
single page	`app config`	Set to 'y' to allow the original page of a survey to persist while dynamically replacing some of the content. A page refresh actually never occurs, thus letting the respondent complete the survey on a single browser page.
size	text responses	Specifies the size (in ems) of the response text input.
skip if	any question	Used to dynamically hide questions, tables, or text if a condition is true.
skip if only columns	any table with columns	Skips the question if only the specified option IDs are present.
skip if only options	any question	Skips the question if only the specified option IDs are present.
skip if only rows	any table with rows	Skips the question if only the specified option IDs are present.
sort for	valid on text widgets	Used on text variables to sort and reorder list options.
star count	`type: stars`	Specifies the number of stars to use in a rating system. Accepts whole numbers for input. Defaults to 5 stars.
star size	`type: stars`	Specifies the display size of the stars. Options include: 'xs', 'sm', 'md', 'lg', or 'xl'. Defaults to 'md' star size.
star width	`type: stars`	Specifies the horizontal space between each star in pixels.
start date	`type: date`	Indicates a start date for the date entry.
start on page	`app config`	Indicates the page upon which respondents will start the survey when they first enter.
start scroll	mobile-friendly theme radio tables	Used with radio tables to specify number of row the respondent must answer before the table will being scrolling. Defaults to half the rows showing.
start sweep	CheatSweep	Sets a limit to the number of respondents that should be allowed into the survey before CheatSweep starts sweeping the data. By default, CheatSweep will begin analyzing data after 50 respondents.
start table	Advanced tables only	Initiates table widget; requires alphanumeric ID for table. Must be paired with the `end table` tag.
statements from	MaxDiffs	Behaves like the 'optsfrom' for a MaxDiff. Specifies where to pull the statements (options) that are being rated. Required for all MaxDiffs.
statement shows	MaxDiffs	For use without the `design from` tag; specifies the number of times to display a statement to the respondent.
statements per page	MaxDiffs	For use without the `design_from` tag; specifies the number of statements to display on each page to the respondent.
status	`end survey`	Specifies the respondent status, using one of the default statuses or a custom status defined with `set status`.
status if over	`type: quotas`	If defined, will change an over quota's respondent status to whatever the input tag is.
step	`type: stars`, text tables, slider questions, numeric questions	Specifies how much a star, slider, or numeric text entry should increase or decrease.
step layout (layout)	`type: stars`, text tables	Specifies the location of the buttons used to increment/decrement the respondent's input.
steps	`selectby: steps`	Defines the quota selection process with a series of programming steps.
steps chapter	`selectby: steps`	Changes the step question's location in the reporting field tree
subject	`send email`	Specifies the subject of an e-mail message.

T

Tag	For use with...	Description
table heading	MaxDiff, tables	Defines the heading text that will appear above the statements column in the MaxDiff table on every page of the exercise. Sets an overall table heading across the option columns in a table.
table mode	`set defaults`	Specifies a global display setting for all tables in a survey unless a widget locally contains a `mode` tag to override the `table mode` setting.
table position	tables	Specifies where the table is to be justified horizontally on the page. Inputs may be 'left', 'right', or 'center'. Defaults to 'left' if omitted.
targetable	`type: quotas`	Apply to quota widgets so that "over quota" respondents will be classified as status 'G' (Targetable Quota) instead of status 'Q' (Over Quota).
targetsfrom	card sorts	Specifies the list which is used to create the targets.
targetorder	card sorts	Specifies the order to apply to the targets. This overrides any previous ordering on the original list or sheet called by the `targetsfrom` tag.
targetstyle	card sorts	Allows user to add custom CSS for styling the targets.
template data	custom templates	Works in conjunction with custom templates.
term after	any question/variable, widget	Defines a point later in the survey where respondents should be terminated, rather than terminate immediately.
term dup	CheatSweep	Accepts 'y' and 'n'; determines if a duplicate respondent should be classified as a termination (status T) by sending them to the "term" end group, or classified as a duplicate (status D) and sending them to the "dupe" end group.
term page	`app config`	Where respondent is routed when terminated.
term if	any question/variable	Used to establish the logic for a termination condition.
terminate	`end survey`	Accepts 'y'/'n' input. If set to 'y', it marks the respondent status as terminated ('T').
term text	any question/variable	Used to define the text displayed in reports which describes the reason for termination.
text	`embed video`, `set text`, `send email`, and free text	Specifies the text to display on screen or in an email.
text align	tables, contratext tables	Changes the alignment of the text in the rows.
text file	`send email`	Specifies a plain ASCII text file that contains the body of the e-mail message you want to send. The file must be stored in the /_s/ directory. The file name must then be supplied here without a path.
text heading	tables, contratext tables	Creates a header above the rows.
text heading align	tables, contratext tables	Changes the alignment of the heading above the rows.
text placement	`embed video` and `set text`	Modifies the location for the text. Acceptable inputs are: 'above', 'below' (default), 'left', 'only', and 'right'.
text rows	textbox questions	Specifies the visible number of lines. If not specified, the default is three rows.
text width	tables, contratext tables	Specifies a width in pixels for the rows.
threshold	CheatSweep	Sets a minimum CheatSweep probability (csp) score for considering a respondent as possible fraud. Input may be an integer or decimal between 1 and 99.
title	`app config`	Specifies the page title for every page of the survey.
to	`send email`	Specifies the target (To) e-mail address, or a comma-separated list of e-mail addresses, for an outgoing e-mail message.
to name	`send email`	Specifies a descriptive name to insert in place of the target (To) address for an outgoing e-mail message.
track qual	quotas	Automates the creation of a multi-select survey variable which tracks all quota buckets for which a respondent could have qualified.
track selector/track picker	MaxDiff	Allows for easy track selection when a user is testing a survey. This only appears when the record contains a `testmode` value; no code changes necessary before launching a survey.
translate	all question/variable types except quotas	Accepts 'y' and 'n'; apply to survey elements that should not be translating, including lists and sheets. Allows SPs are to specify the languages for which a survey element should be translated.
trigger (trigger checklist)	checklists	A checklist is a multi-punch system variable that serves as a flag to identify respondents who meet a particular condition, such as failing an attention check. Once a checklist is defined, it may be triggered anywhere in the survey. Each instance of a trigger automatically adds an option to the checklist. That option is punched if the trigger's condition is met when the respondent submits the survey page containing the trigger. Checklists may be triggered using a `trigger checklist` widget, a `trigger` tag on a question, or a `trigger` decorator on an option.
type	all question types and video	Specifies what category of responses is allowed for a given question, table, or variable.

U

Tag	For use with...	Description
unchain	translations	Separates matching content in a translation overlay, allowing for unique translations within the same language.
unstackby and unstackfor (stackby and stackfor)	stacking data	Allows reports to automatically show questions with stacked data with the full brand list, rather than the proxy list built from variables storing brands.
use cardsort id	card sorts	Toggles using the ID of the card sort concatenated with a "C" and the option IDs of the targets list to create variable names, or to just use the targets list to create the variable names.
use panels	`app config`	Specifies a list of which panel numbers should be used in the survey. There must also be a system sheet 'system_panels', or a local sheet which lists all panel numbers that it will call to.
use table id	tables	Accepts 'y' and 'n'; defaults to 'y'. Specifies whether or not to name the "questions" (rows in normal tables; columns in vertical scale, or "vscale" tables) based on the table ID specified in the source code.

V

Tag	For use with...	Description
validation (validate)	any question/table type	Evaluates a logical condition and prevents the respondent from continuing to the next page if the condition is false.
valid day	`type: date`	Indicates the days of the week that are allowed to be selected within the calendar control.
value display	`type: stars`, slider and radio slider questions	Accepts 'y' and 'n'; if set to 'n', will hide the text displayed to the right of (or below) the stars. Defaults to 'y'. Specifies whether or not to display the value selected on the slider scale.
video link (link)	`embed video` and `type: video`	Defines the location where the video is hosted. Uses a URL as the input and must end with 'mp4'.
video nojs	`set text`	Displays a custom message to the respondent if no JavaScript is found on their device.
vertical	slider and radio slider questions	Accepts 'y' and 'n'; set to 'y' to flip scale orientation to vertical.
vscale	tables	Presents question elements in a table as columns rather than rows.

W

Tag	For use with...	Description
warn	validate	Allows respondents to fail validation criteria and proceed by resubmitting the page after a second attempt. To convert a regular validation into a warning, add the warn tag or decorator.
width	slider and radio slider questions	Specifies the width of the slider widget in either pixels or as a percent (with percent sign); integer input.
why	any question type	Adds a follow-up textbox to a question asking why a question was answered in a specific way.

X/Y/Z

Non-alphabetical tags

Tag	For use with...	Description
--	multi-type tables	Separates columns so that each column of questions in a table can be defined. This is especially helpful for columns that vary in response type (radio, checkbox, pulldown, text).

Related to

Search

A

B

C

D

E

F

G/H

I

J/K

L

M

N

O

P

Q

R

S

T

U

V

W

X/Y/Z

Non-alphabetical tags

Comments

A

B

C

D

E

F

G/H

I

J/K

L

M

N

O

P

Q

R

S

T

U

V

W

X/Y/Z

Non-alphabetical tags

Related articles