\n
Is something in your course not working as expected? Don't panic. Instead, follow the Eightfold Path for Troubleshooting.
\n
***************************************************
\n
Update: The info in the rest of this post was expanded into an Articulate webinar. That's available on-demand (under their title for it):
\n
https://training.articulate.com/webinars/ensure-smooth-sailing-in-storyline-by-following-8-pro-tips
\n
***************************************************
\n
These suggestions are based on common issues I've seen in the Forum. They won't help you reach nirvana, but they might help you fix your Storyline file.
\n
\n
\nRight names
\n
\n
\n- Name objects, layers, variables, and motion paths.
\n- Relevant names make initial programming and troubleshooting easier. They also help any future developers who may work on your file. (Or help your future self when you return to it at a later date.)
\n- For example, it's easier to select from motion paths called \"Go_Left,\" \"Go_Right,\" \"Go_Up,\" and \"Go_Down\" rather than \"Line Motion Path 1,\" \"Line Motion Path 2,\" \"Line Motion Path 3,\" and \"Line Motion Path 4.\"
\n
\n
\n
\n Right states
\n
\n
\n- Use default states to take advantage of their built-in functionality. Use custom states for special programming.
\n- Don't interfere with default states by adding unnecessary triggers. For example, there's no need to have a trigger to change to the Hover state on mouseover. That will happen automatically if an object has a Hover state.
\n- Here's more info about built-in states: PRIMER: Take advantage of built-in states | Articulate - Community
\n
\n
\n
\nRight actions
\n
\n
\n- Verify that triggers are set to perform the proper action.
\n- For example, a \"jump to next slide\" trigger won't work on the last slide in a scene. In that case, the right action would be to jump to the next scene, jump to a specified scene, or jump to a specified slide.
\n
\n
\n
\nRight selections
\n
\n
\n- Verify that the correct items are selected in the triggers.
\n- For example, does the trigger impact the appropriate object? Show the corresponding layer? Are the conditions based on the proper variables?
\n- This is where a good naming convention is a tremendous help for troubleshooting!
\n
\n
\n
\nRight timing
\n
\n
\n- Verify that the \"when\" in each trigger will occur, that it will happen on the same slide as the trigger, and that the triggers will run in the proper sequence.
\n- For example, if you want a trigger to run when a variable changes, the variable has to be adjusted on that slide. Otherwise, the trigger won't \"see\" the change happen, so the trigger won't ever run. (Any trigger can, however, use the value of any variable in a condition.)
\n- Also, if one button includes multiple triggers, any trigger that jumps to another slide needs to come after the other triggers. (The program can't run triggers if it has already left the slide where the triggers are.)
\n
\n
\n
\nRight properties
\n
\n
\n- Verify the settings for Player, Slide, and Slide-Layer Properties.
\n- For example, if you want to replay the timeline whenever someone revisits a slide, set its Slide Properties to \"Reset to initial state.\" If you don't want it to replay, set it to \"Resume saved state.\"
\n- By the way, it's a good idea to be familiar with all the options available in Properties. They include some built-in functions that can reduce the need for certain triggers.
\n
\n
\n
\nRight values
\n
\n
\n- Verify variable values by inserting those references in a text box on the corresponding slide(s) during development.
\n- This helps you see exactly how and when a variable changes. If the value doesn't change as expected and when expected, check for right actions, right items, and right timing.
\n- Before publishing, you can move the reference text box off the slide, hide it, or delete it.
\n
\n
\n
\nRight conditions
\n
\n
\n- Verify that any trigger conditions include the right selections and right values.
\n- Pay special attention to how multiple conditions are connected. Using \"and\" means the trigger will only run when all conditions are met. Using \"or\" means the trigger will run if any condition is met.
\n
\n
","kudosSumWeight":0,"postTime":"2021-10-07T11:07:21.000-07:00","images":{"__typename":"AssociatedImageConnection","edges":[],"totalCount":0,"pageInfo":{"__typename":"PageInfo","hasNextPage":false,"endCursor":null,"hasPreviousPage":false,"startCursor":null}},"attachments":{"__typename":"AttachmentConnection","pageInfo":{"__typename":"PageInfo","hasNextPage":false,"endCursor":null,"hasPreviousPage":false,"startCursor":null},"edges":[]},"tags":{"__typename":"TagConnection","pageInfo":{"__typename":"PageInfo","hasNextPage":false,"endCursor":null,"hasPreviousPage":false,"startCursor":null},"edges":[{"__typename":"TagEdge","cursor":"MjUuMnwyLjF8b3wxMHxfTlZffDE","node":{"__typename":"Tag","id":"tag:advice","text":"advice","time":"2024-08-27T05:27:09.615-07:00","lastActivityTime":null,"messagesCount":null,"followersCount":null}},{"__typename":"TagEdge","cursor":"MjUuMnwyLjF8b3wxMHxfTlZffDI","node":{"__typename":"Tag","id":"tag:storyline 360","text":"storyline 360","time":"2014-10-09T03:01:38.000-07:00","lastActivityTime":null,"messagesCount":null,"followersCount":null}}]},"timeToRead":3,"currentRevision":{"__ref":"Revision:revision:460735_2"},"latestVersion":null,"metrics":{"__typename":"MessageMetrics","views":117},"visibilityScope":"PUBLIC","canonicalUrl":null,"seoTitle":null,"seoDescription":null,"isEscalated":null,"placeholder":false,"originalMessageForPlaceholder":null,"messagePolicies":{"__typename":"MessagePolicies","canModerateSpamMessage":{"__typename":"PolicyResult","failureReason":{"__typename":"FailureReason","message":"error.lithium.policies.feature.moderation_spam.action.moderate_entity.allowed.accessDenied","key":"error.lithium.policies.feature.moderation_spam.action.moderate_entity.allowed.accessDenied","args":[]}}},"archivalData":null,"customFields":[]},"Conversation:conversation:460735":{"__typename":"Conversation","id":"conversation:460735","solved":false,"topic":{"__ref":"ForumTopicMessage:message:460735"},"lastPostingActivityTime":"2025-03-10T13:47:29.196-07:00","lastPostTime":"2024-08-28T13:30:28.470-07:00","unreadReplyCount":11,"isSubscribed":false},"ModerationData:moderation_data:460735":{"__typename":"ModerationData","id":"moderation_data:460735","status":"APPROVED","rejectReason":null,"isReportedAbuse":false,"rejectUser":null,"rejectTime":null,"rejectActorType":null},"Revision:revision:460735_2":{"__typename":"Revision","id":"revision:460735_2","lastEditTime":"2025-03-10T13:47:29.196-07:00"},"ForumReplyMessage:message:1197135":{"__typename":"ForumReplyMessage","id":"message:1197135","conversation":{"__ref":"Conversation:conversation:460735"},"author":{"__ref":"User:user:1283207"},"revisionNum":1,"uid":1197135,"depth":2,"hasGivenKudo":false,"subscribed":false,"board":{"__ref":"Forum:board:discuss"},"subject":"Re: TIP: The Eightfold Path of Troubleshooting","readOnly":false,"editFrozen":false,"moderationData":{"__ref":"ModerationData:moderation_data:1197135"},"parent":{"__ref":"ForumReplyMessage:message:1197132"},"body":"Fabulous resource that stands the test of time.
","body@stringLength":"54","rawBody":"Fabulous resource that stands the test of time.
","author":{"__ref":"User:user:391597"},"isEscalated":null,"postTime":"2024-08-28T13:20:11.589-07:00","solution":false,"customFields":[],"attachments":{"__typename":"AttachmentConnection","edges":[],"pageInfo":{"__typename":"PageInfo","hasNextPage":false,"endCursor":null,"hasPreviousPage":false,"startCursor":null}},"kudosSumWeight":0,"repliesCount":1,"images":{"__typename":"AssociatedImageConnection","edges":[],"totalCount":0,"pageInfo":{"__typename":"PageInfo","hasNextPage":false,"endCursor":null,"hasPreviousPage":false,"startCursor":null}},"timeToRead":1,"currentRevision":{"__ref":"Revision:revision:1197132_1"},"latestVersion":null,"metrics":{"__typename":"MessageMetrics","views":18},"visibilityScope":"PUBLIC","placeholder":false,"originalMessageForPlaceholder":null,"messagePolicies":{"__typename":"MessagePolicies","canModerateSpamMessage":{"__typename":"PolicyResult","failureReason":{"__typename":"FailureReason","message":"error.lithium.policies.feature.moderation_spam.action.moderate_entity.allowed.accessDenied","key":"error.lithium.policies.feature.moderation_spam.action.moderate_entity.allowed.accessDenied","args":[]}}}},"Revision:revision:1197135_1":{"__typename":"Revision","id":"revision:1197135_1","lastEditTime":"2024-08-28T13:30:28.470-07:00"},"QueryVariables:ReplyList:message:1197135:1":{"__typename":"QueryVariables","id":"ReplyList:message:1197135:1","value":{"id":"message:1197135","first":10,"sorts":{"postTime":{"direction":"ASC"}},"repliesFirst":3,"repliesFirstDepthThree":1,"repliesSorts":{"postTime":{"direction":"ASC"}},"useAvatar":true,"useAuthorLogin":true,"useAuthorRank":true,"useBody":true,"useKudosCount":true,"useTimeToRead":false,"useMedia":false,"useReadOnlyIcon":false,"useRepliesCount":true,"useSearchSnippet":false,"useAcceptedSolutionButton":true,"useSolvedBadge":false,"useAttachments":false,"attachmentsFirst":5,"useTags":false,"useNodeAncestors":false,"useUserHoverCard":false,"useNodeHoverCard":false,"useModerationStatus":true,"usePreviewSubjectModal":false,"useMessageStatus":true}},"ROOT_MUTATION":{"__typename":"Mutation"},"CachedAsset:text:en_US-shared/client/components/users/UserAvatar-1743008493885":{"__typename":"CachedAsset","id":"text:en_US-shared/client/components/users/UserAvatar-1743008493885","value":{"altText":"{login}'s avatar","altTextGeneric":"User's avatar"},"localOverride":false},"CachedAsset:text:en_US-shared/client/components/ranks/UserRankLabel-1743008493885":{"__typename":"CachedAsset","id":"text:en_US-shared/client/components/ranks/UserRankLabel-1743008493885","value":{"altTitle":"Icon for {rankName} rank"},"localOverride":false},"CachedAsset:text:en_US-components/messages/AcceptedSolutionButton-1743008493885":{"__typename":"CachedAsset","id":"text:en_US-components/messages/AcceptedSolutionButton-1743008493885","value":{"accept":"Mark as Solution","accepted":"Marked as Solution","errorHeader":"Error!","errorAdd":"There was an error marking as solution.","errorRemove":"There was an error unmarking as solution.","solved":"Solved","topicAlreadySolvedErrorTitle":"Solution Already Exists","topicAlreadySolvedErrorDesc":"Refresh the browser to view the existing solution"},"localOverride":false},"CachedAsset:text:en_US-components/messages/ThreadedReplyList-1743008493885":{"__typename":"CachedAsset","id":"text:en_US-components/messages/ThreadedReplyList-1743008493885","value":{"title":"{count, plural, one{# Reply} other{# Replies}}","title@board:BLOG":"{count, plural, one{# Comment} other{# Comments}}","title@board:TKB":"{count, plural, one{# Comment} other{# Comments}}","title@board:IDEA":"{count, plural, one{# Comment} other{# Comments}}","title@board:OCCASION":"{count, plural, one{# Comment} other{# Comments}}","noRepliesTitle":"No Replies","noRepliesTitle@board:BLOG":"No Comments","noRepliesTitle@board:TKB":"No Comments","noRepliesTitle@board:IDEA":"No Comments","noRepliesTitle@board:OCCASION":"No Comments","noRepliesDescription":"Be the first to reply","noRepliesDescription@board:BLOG":"Be the first to comment","noRepliesDescription@board:TKB":"Be the first to comment","noRepliesDescription@board:IDEA":"Be the first to comment","noRepliesDescription@board:OCCASION":"Be the first to comment","messageReadOnlyAlert:BLOG":"Comments have been turned off for this post","messageReadOnlyAlert:TKB":"Comments have been turned off for this article","messageReadOnlyAlert:IDEA":"Comments have been turned off for this idea","messageReadOnlyAlert:FORUM":"Replies have been turned off for this discussion","messageReadOnlyAlert:OCCASION":"Comments have been turned off for this event"},"localOverride":false},"CachedAsset:text:en_US-shared/client/components/nodes/NodeIcon-1743008493885":{"__typename":"CachedAsset","id":"text:en_US-shared/client/components/nodes/NodeIcon-1743008493885","value":{"contentType":"Content Type {style, select, FORUM {Forum} BLOG {Blog} TKB {Knowledge Base} IDEA {Ideas} OCCASION {Events} other {}} icon"},"localOverride":false},"Revision:revision:1197132_1":{"__typename":"Revision","id":"revision:1197132_1","lastEditTime":"2024-08-28T13:20:11.589-07:00"},"CachedAsset:text:en_US-components/tags/TagView/TagViewChip-1743008493885":{"__typename":"CachedAsset","id":"text:en_US-components/tags/TagView/TagViewChip-1743008493885","value":{"tagLabelName":"Tag name {tagName}"},"localOverride":false}}}},"page":"/forums/ForumMessagePage/ForumMessagePage","query":{"boardId":"discuss","messageSubject":"tip-the-eightfold-path-of-troubleshooting","messageId":"460735","replyId":"1197135"},"buildId":"Btkyb7T6TeYM9D2gUmiOv","runtimeConfig":{"buildInformationVisible":false,"logLevelApp":"info","logLevelMetrics":"info","openTelemetryClientEnabled":false,"openTelemetryConfigName":"articulate","openTelemetryServiceVersion":"25.2.0","openTelemetryUniverse":"prod","openTelemetryCollector":"http://localhost:4318","openTelemetryRouteChangeAllowedTime":"5000","apolloDevToolsEnabled":false,"inboxMuteWipFeatureEnabled":false},"isFallback":false,"isExperimentalCompile":false,"dynamicIds":["./components/seo/QAPageSchema/QAPageSchema.tsx","./components/customComponent/CustomComponent/CustomComponent.tsx","./components/community/Navbar/NavbarWidget.tsx","./components/community/Breadcrumb/BreadcrumbWidget.tsx","./components/messages/TopicWithThreadedReplyListWidget/TopicWithThreadedReplyListWidget.tsx","./components/messages/RelatedContentWidget/RelatedContentWidget.tsx","./components/messages/MessageListForNodeByRecentActivityWidget/MessageListForNodeByRecentActivityWidget.tsx","./components/messages/MessageView/MessageViewStandard/MessageViewStandard.tsx","./components/customComponent/CustomComponentContent/TemplateContent.tsx","../shared/client/components/common/List/UnstyledList/UnstyledList.tsx","./components/messages/MessageView/MessageView.tsx","./components/messages/MessageView/MessageViewInline/MessageViewInline.tsx","../shared/client/components/common/List/ListGroup/ListGroup.tsx","../shared/client/components/common/Pager/PagerLoadMore/PagerLoadMore.tsx","../shared/client/components/common/List/UnwrappedList/UnwrappedList.tsx","./components/tags/TagView/TagView.tsx","./components/tags/TagView/TagViewChip/TagViewChip.tsx"],"appGip":true,"scriptLoader":[]}