One Trick for Testing Variables in Storyline


You set up a variable, add a trigger, and preview the course. The button fires. But nothing changes, and you’re not sure why.

What a reference variable is

A reference variable is a text box that displays the current value of a variable. You place it on a slide during development. When you preview the course, you can watch the value update in real time as you interact with it.

Without one, you’re guessing. You click the button and assume the variable changed because the trigger looks correct. A reference removes that assumption and shows you exactly what’s happening.

If the value updates when expected, you know the variable logic is working. If it doesn’t, you know where to dig. Either way, you’re troubleshooting with real information instead of inference.

It’s how I built this dashboard to change my variables when I review courses.

Where to put reference variables

You need to remove or hide them before publishing. Here are four approaches, each with different tradeoffs:

  • Delete them before publishing. Simple and clean, but you’ll need to recreate them if you come back to edit.
  • Move them off the slide. They’re preserved, but you have to move them back on whenever you’re troubleshooting again.
  • Hide them on the timeline. They stay on the slide and only take a click to reveal. Good for individual slides.
  • Put them on the master slide. Turn them off on the master and they disappear across every slide at once.

The master slide method wins because it scales. One toggle and your reference variables are hidden everywhere in the course. When you need to debug again, one toggle brings them back.

Key takeaways

Reference variables for testing and debuggin are a small habit that pays off across every project. As your courses get more complex with branching, scoring, and conditional logic, being able to see what’s happening in real time saves hours.