Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form below and we will reply as soon as possible.

  • Appcues Certifications & Training
  • Integration Hub
  • Contact Us
  • Docs home
  • Web Experiences
  • Troubleshooting

Troubleshooting Checklists

Some guidance to help you troubleshoot why your Checklist isn't showing or identify other issues.

Updated at June 17th, 2025

Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form with the details about the help content you'd like to see.

  • Installation & Developers
    Installing Appcues Web Installing Appcues Mobile API & Data Troubleshooting Extras
  • Web Experiences
    Flows Launchpads Pins Checklists Banners NPS Surveys & Forms Targeting and Triggering Customization & Styling Troubleshooting Use Cases FAQ
  • Mobile Experiences
    Installation & Overview Building Mobile Experiences Mobile Analytics & Integrations Troubleshooting
  • Workflows
    Building & Configuration Use Cases Workflow Analytics and Integrations
  • Account Management
    Subscription Users & Data
  • Analytics & Data
    Experience and Event Analytics Users & Accounts
  • Best Practices
    Best Practices Use Cases Pro Tips Product-led Growth
  • Integrations
    Integration Documents Use Cases Extras
  • System Status
    System Status & Incidents
+ More

Table of Contents

1. Is Appcues installed where the Checklist should show? 2. Is the user eligible? 3. Did the user dismiss the Checklist? 4. Are your user properties still being correctly sent to Appcues? 5. Checklist item isn't checking off 6. Is page targeting correct? 7. Other common issues Regex evaluation Using multiple conditions Content Security Policies Still stuck?

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

1. Is Appcues installed where the Checklist should show?

The first thing to check when troubleshooting the Checklist, is to verify if Appcues is installed properly on pages where you expect the Checklist 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?

Navigate to the 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. 

Zight Recording 2025-06-12 at 10.47.09 AM

Once you have your user, go to the Eligibility tab.

Clicking any Ineligible link will open up an explainer showing more detail on why the user is ineligible for the Checklist. If you see a red X next to Audiences that means that the user is failing that condition. 

To dig deeper into why the user fails the audience criteria, compare the User Profile of that user with your targeting to see if they are getting identified with the correct data.

For instance, your Checklist is targeting users with a Role = Tester. If you compare what value your user has for Role, you can see if there's a mismatch or an issue with capitalization. In this case, the user would not see the Checklist because the value is tester (no capitalization). Values entered are case-sensitive.

3. Did the user dismiss the Checklist?

If your checklist is dismissible and a user dismisses it, it won't appear to them again. You can verify if that is the case by looking at the Checklist Skipped events in Events Explorer. Navigate to the Events Explorer, filter by Checklist events, find your Checklist and then click on the Checklist Skipped event to open that event. Search for the user and see if they're listed among the users dismissing the Checklist. You may have to adjust the time-frame you're looking at at the top of the page.

4. 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 for a Checklist survey. 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:

5. Checklist item isn't checking off

Verify that your user is reaching the criteria defined on the item. For example, if you're using a Flow completion criteria, verify that the user is seeing/completing the Step Group you set in your Checklist. The criteria in the screenshot below specifically mentions completing Step Group 3, so make sure you're completing the Flow up until that point. 

If you're using a User property or an Event, check your user's profile to see if the user matches the value (if using a user property) or if the user has triggered the event.

6. Is page targeting correct?

Enter the URL you're expecting to see the Checklist in the Test Page Targeting tool, on your Checklist settings page. It will tell you whether or not it matches the page and domain conditions you set above.

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 Checklist 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 Checklist 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?

As always, if you have any challenges with your checklist that you can't figure out, reach out to our support team and we'll help sort things out!

where is my checklist checklist not showing troubleshoot checklist

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Content Security Policies
  • Preview and Test your Checklist
  • Create Checklist items that can be completed by anyone on an account
  • Installation Testing / Debugging
Appcues logo

Product

Why Appcues How it works Integrations Security Pricing What's new

Use cases

Appcues Integration Hub User Onboarding Software Feature Adoption Software NPS & Surveys Announcements Insights Mobile Adoption

Company

About
Careers

Support

Developer Docs Contact

Resources

The Appcues Blog Product Adoption Academy GoodUX Case studies Webinar Series Made with Appcues Appcues University

Follow us

Facebook icon Twitter icon grey Linkedin icon Instagram icon
© 2022 Appcues. All rights reserved.
Security Terms of Service Privacy Policy

Knowledge Base Software powered by Helpjuice

Expand