In this article, we’ll cover some quick actions that you can take to identify some common issues and causes to troubleshoot your Launchpad.

1. Is Appcues installed where the Launchpad should show?

The first thing to check when troubleshooting the Launchpad, is to verify if Appcues is installed properly on pages where you expect the Launchpad to show up. To do this, open the Appcues debugger (if you don't know how to do this, please check this guide!) and ensure that all rows have a green checkmark like in the screenshot below.

If you see any red errors persisting on any or multiple lines, you're running into an installation issue that needs to be fixed.

2. Is the user eligible?

Make sure your user meets the Launchpad targeting rules. Check the segment used and verify that the user belongs to the segment. 

A quick way to do that is to go your Users page and search for your user. If you want to learn more about how you can find users, check out our documentation: Finding a User.

After you find your user, check the segments tab. The segment you're using in your Launchpad should appear here. If it doesn't, it means that your user doesn't belong to the segment and isn't eligible to see the Launchpad.

3. Are your user properties still being correctly sent to Appcues?

If you are targeting your customers based on a property that is no longer being sent or being sent incorrectly, we won't be able to successfully target them the Launchpad. One way you can check this is by visiting your Properties page and checking for the property as well as the last time we received it:

4. Is page targeting correct?

Enter the URL you're expecting to see the Launchpad in the Test Page Targeting tool, on your Launchpad's settings page.

It will tell you whether or not it matches the page and domain conditions you set above.

5. Flow isn't showing in the Launchpad

Flows shown on a Launchpad respect audience targeting. If you've set a series of Flows to show in your Launchpad but you can only see part of them or none at all, it's likely your user isn't eligible to see them. You can verify if that is the case using the method described here. Additionally, Flows that are event triggered do not show up in the Launchpad.

6. Why am I seeing multiple Launchpads?

If you've published multiple Launchpads and your user is eligible to see them all, they will show simultaneously.

7. Other common issues

Regex evaluation

If using a regex pattern, make sure the operator selected is 'matches regex' and verify that the pattern is valid with a Regex tester.

Using multiple conditions

If using multiple conditions, verify that they're not mutually exclusive or conflicting with each other. For example, if I wanted to show my Launchpad on different pages that contain 'account', 'dashboard', and 'payments', the settings below wouldn't work because all the conditions would need to match at once. This would only show on a URL that looks like this: https://myappcues.com/account/dashboard/payments

In order to show the Launchpad on different pages containing those words, using the condition Any (OR) is the right way to go! This would show on different URLs, such as:

https://myappcues.com/account/

https://myappcues.com/dashboard/

Content Security Policies

Some software products use a content security policy that automatically blocks resources that are not explicitly allowed. Such security policies may cause Appcues' editor or SDK to fail to load properly. You can confirm if that is the case if you open your browser's console and check for errors. To open your console, right-click anywhere on the page and select inspect. Then, make sure you're on the console tab and check if any errors mention a Content Security Policy related to Appcues. Read our article to learn how to adjust these policies on your end.

Still stuck?

Reach out to our support team for assistance.