The aytm Logic Guide brings the aytm Logic Reference into the Survey Editor, so you can look up logic without leaving your survey. Search for a command or concept to see what it does with examples, copy the start of a logic rule with one click, and drag live logic examples into your survey to see them work.
Learn more about aytm Logic in the Lighthouse Academy!
In This Article
- Opening the Logic Guide
- Using the Logic Guide
- Viewing Live Logic Examples
- What the Logic Guide covers
- Tips and troubleshooting
Opening the Logic Guide
The Logic Guide sits in the row of tool icons next to the Survey Editor, together with Question Library, Survey Comments, Survey History and Checkout. Its icon shows the tooltip aytm Logic guide when you hover over it.
- On a wide browser window, the tool icons float along the right side of the Survey Editor.
- On a narrower window, the same icons move into the left sidebar of the editor.
Click the icon to open the Logic Guide panel. Click it again, or click the arrow at the end of the icon row, to close the panel.
⚠️ Note: The Logic Guide icon is grayed out while you're viewing an earlier version of the survey from Survey History, and while Skipper is still drafting your survey. Return to the current version, or wait for the draft to finish, to use it.
Using the Logic Guide
- Open the Logic Guide.
- Type a logic term into the search field, such as
show if,maskorpiping. As you type, up to five suggestions appear. Topics whose names match your search are listed first, followed by topics that mention your term in their description. - Click a suggestion to open that topic.
- Read the topic. Each topic can include:
- Examples of the rule, with an explanation of what each one does.
- show more… to expand the full description of the topic.
- Open aytm Logic Article >>, which opens the aytm Logic section of the Help Center in a new tab.
- SEE ALSO: related topics. Click one to jump to it.
- Live Logic examples for that topic (see Viewing Live Logic Examples).
- For logic commands, the topic shows a copy box inside a dotted border, such as [Skip to...] or [Show if...]. Click the box to copy it. Copied! appears to confirm.
- Paste the text into the question, answer or other field in your survey where the logic should apply, then finish the rule.
⚠️ Note: Most copy boxes copy only the start of a rule. For example, [Skip to...] copies
[Skip to. After you paste it, type the rest of the rule and the closing bracket, e.g.,[Skip to Q10 if Q5A2]. Use the topic's examples as a model. Only [Show], [Hide] and [Hide text] copy a complete rule.
Topics about concepts rather than commands, such as Direct references, Piping Text or Comma = AND, have no copy box. Type the syntax from their examples into your survey instead.
If nothing matches your search, the Logic Guide shows Sorry, we couldn't find anything relevant. and suggests searches such as "Show if" and "Hide if". Try a shorter term or the name of the command.
Viewing Live Logic Examples
Live Logic examples are ready-made survey questions with logic already set up. Drop one into your survey to see how a type of logic is written and how it behaves when you preview the survey.
Live Logic examples appear in two places:
- Under the search field, when you haven't searched yet. This list always starts with two Smart Loop examples, followed by up to five logic examples. The examples you dragged most recently are listed first; the rest are defaults such as MASK A LIST BY CHOSEN OPTIONS, SHOW IF... AN ANSWER IS CHOSEN and SKIP TO... IF AN ANSWER IS CHOSEN.
- Under a topic, when that topic has matching examples. For instance, the [Skip to...] topic includes SKIP TO EXIT, SKIP TO A RANDOM QUESTION and SKIP TO... BASED ON @ALIAS.
To use a live example:
- Click and drag the example by its handle, then drop it at the place in your survey where you want it.
- The example adds one or more sample questions with the logic already in their text. Smart Loop examples add a complete Smart Loop with sample variables.
- Preview the survey to see the logic in action.
- Replace the sample text and images with your own questions and answer options, or delete the example. To delete a question, hover over it and click the X that appears to its left (tooltip: Remove question).
💡 Tip: Live examples are written as if they were the only questions in the survey. Before you launch, check that each rule in the example (such as
Q1A1) points to the question you mean.
What the Logic Guide covers
The Logic Guide has 44 topics. Search for any of the topic names below to open it.
| Area | Topics |
|---|---|
| References and variables | Direct references, Aliases, Variables, Arrays, Arrays: shuffle, Arrays: reverse, Arrays: unique, Arrays: sort, Arrays: sort elements |
| Conditions and piping | Exposure, Choice, Piping Text, Response Text, Number of Responses, Comment Text, Item position, Convert to numeric value, Image, Random number |
| Ranges | Comma = AND, Colon = AND, Dot = OR, Dash = OR, Multi-level |
| Survey flow and display commands | [Skip to...], [Show if...], [Hide if...], [Hide text], [Mask by...], [Rev-mask by...], [Group...], [Group ... randfill], [Group ... balance ...], [Glue...], [Exclusive...], [Show first/last ...], [Sort by a-z...] |
| Shelf Test and Menu Test | [shelf {...}, {...}...] (Shelf Test placement), In section, In shape, In cluster (Menu Test) |
| General reference | Priority (which rule wins when rules conflict), Glossary (the full list of commands and operators), Misc (case, combining rules, showing literal brackets) |
For the complete syntax in one place, see the aytm Logic Reference Guide, where you can also download it as a PDF.
Tips and troubleshooting
-
Search by command name. Terms like
skip,mask,glueorgroupmatch topic names directly and give the best results. Questions such as "how do I hide an answer" work less well thanhide. -
Start typing a bracket in the survey. Typing
[in any survey field starts a logic rule. If aytm Logic autocomplete is on for the survey, it suggests commands and references as you type. - The recently used list is per browser. The Logic Guide remembers the live examples you drag in this browser only. A different browser or computer shows the defaults.
- A finished rule shows an error. Compare it with the examples in its topic. Check the closing bracket and the question and answer numbers.
- Need more help? Contact our Customer Engagement team from the Human Support tab in Skipper.
