Why Aren't My Flows Showing?
If you have published a flow and are having trouble viewing it live on your site, there could be a few reasons why it's not showing. Here are a few steps you can take to quickly identify what's going on:
1. Preview your flow in the editor
Our preview function in our editor is the first way to determine if your flow will display on your site when published. To preview the flow, make sure you are on the right page view of where your flow should start and select the eye icon in the bottom right of your editor.
If your flow does not appear (or doesn't display all the way through), chances are that your tooltips or hotspots have been placed on faulty selectors. As you place a hotspot or tooltip on your page, a blue box appears that will reference the element they are attaching to. If the CSS selector is (a) too general and used by other elements on the page or (b) not present at all times, your tooltips or hotspots will not appear and may give a yellow triangle warning symbol.
- Selector is visible and seems to be unique
- Selector cannot be found by Appcues.
- Note: This will happen if you use a selector that is a dynamic element and it is not shown, however, will properly show when the element becomes available
You can change the selector that tooltips or hotspots are attached to either by repositioning your tooltip or entering in a new selector. Learn more about picking the right selector here.
If a flow breaks after a URL/page change, please check if you have a Page Change in your flow and that the settings of the Page Change are correct. Learn more about Page Changes and Redirects
If you are able to preview your entire flow, move on to the next step in troubleshooting by checking your flow settings.
2. Check your flow settings
In order to see your flows live on your site, you'll have to meet all the criteria you set under your Target & Publish rules.
Double check Display settings that...
- You are viewing your flow at the right page: if you selected to show the flow at a specific path, does the page you're viewing match the path you've entered?
Tip: When entering a path, do not put the include the domain. If you'd like your flow to show up at https://yoursite.com/dashboard you should enter /dashboard in the path field
- You are viewing your flow on the domain that your flow is published to
If you set the flow to "Show Once", it will not automatically trigger for you again (even if you unpublish and republish)
Double check Audience settings that...
- You meet all the user properties required to see the flow: if you have the flow targeted to new users, are you using a new account?
- Does your user property targeting match your properties exactly? This targeting is case sensitive. For instance, if you are is targeting users with the property
Roleis equal to
Adminand the actual value of that property is
admin, this will not match
- If you are using "Just My Team" targeting you must also be logged in at my.appcues.com - this targeting is based off your Appcues ID
- If you are A/B testing this flow, are you in the group is it set to display to? (Find out by using the debugger on your site)
If your flow settings match the account you are testing your flows with, move on to check your installation.
3. Check your installation
If the Appcues embed script is not fully installed on your site, flows might only load upon hard refresh or not display at all.
Here are a few ways you can check your installation:
- Refresh the page. If your flow loads, you are likely missing the
Appcues.start()call in your installation.
Appcues.start()lets Appcues know when your URL changes or when a user navigates to a separate part of your site. It's a key part of installation so that your flows work seamlessly as your users explore your platform. Select your platform type here to learn how you can install the Appcues.start() call.
If you have installed Appcues via Segment and can only see your flows with a hard refresh, you may need to add the
analytics.track()call in your Segment installation. Learn more about this Segment call here.
- Open up the Appcues debugger.
?hey_appcuesto the end of the URL your flow should appear on and load the page.
If nothing appears, right-click your page and select Inspect. Open up your console and (at the top level) type in
Appcues.debug()and hit enter.
If nothing appears, Appcues is likely not installed on this page. You can share these installation instructions with your developers so they can install the Appcues embed script on your site.
If you do see the debugger load in the bottom-left of your screen, check for are any reported errors. Learn more about how to use the debugger and understand errors here.
4. Utilize Content Diagnostics
Content diagnostics is a way that we test targeting similar to how the SDK would understand targeting. This allows us to see if it is an issue with any of the targeting elements with your flow, such as page, domain, audience, and frequency!
We have a wonderful guide walking through Flow Diagnostics right here!
Write to us at firstname.lastname@example.org and we'll be happy to help! For the quickest support, please be sure to provide your flow name, a demo login for your site (we'll need to access your targeted page) and any troubleshooting details you might have for us.