Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

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

  • Contact Us
  • Home
  • Web Experiences
  • Troubleshooting

Troubleshooting Checklists

Some guidance to help you troubleshoot why your Checklist stopped showing.

Written by Sofia Domingues

Updated at May 14th, 2025

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

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

  • Installation & Developers
    Installing Appcues Web Installing Appcues Mobile API & Data Troubleshooting Extras
  • Installation & Developers
    Installing Appcues Web Installing Appcues Mobile API & Data Troubleshooting Extras
  • Web Experiences
    Building Web Experiences Targeting Studio Customization & Styling Use Cases Troubleshooting 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
    Experience and Event Analytics Data
  • Best Practices
    Best Practices Use Cases Pro Tips Product-led Growth
  • Integrations
    Integration Documents Use Cases Extras
+ More
  • Home

  • Installation & Developers

    • Installation & Developers

      • Web Experiences

        • Mobile Experiences

          • Workflows

            • Account Management

              • Analytics

                • Best Practices

                  • Integrations

                    Pro-tip: Check out checklist testing for more information on testing your checklist.

                     

                    Keep in mind that the checklist is a connector of content: It references many different flows, user criteria, segments, and behaviors. You're unlikely to get everything right on the first try, but if something doesn't work - don't worry! If you are running into issues with your checklist, follow this order of operations for debugging:

                    1. Double-check your installation. Can you see other Appcues flows? Can you launch the Appcues debugger (by right-clicking the Chrome Extension and choosing 'Debug flows on this page')? Are the correct events & properties being sent by your app?
                    2. Double-check the target audience segment. Are flows targeted to that segment appearing?
                    3. Double-check your URL and page targeting. You can use the URL testing tool to ensure pages match as expected.
                    4. Double-check each item's completion criteria. What was chosen for the "mark completed when" segment?

                    Checklist Diagnostics

                    The checklist diagnostics tool allows you to check whether or not certain users are eligible for your checklist (i.e. to confirm your targeting is set up correctly).

                    This tool, similar to the flow diagnostics tool, is a great way to check in on the setup of your checklist.

                    How to Use the Checklist Diagnostics Tool

                    1. Navigate to the "Diagnostics" page

                    2. Enter a User ID + any page where you expect your checklist to show up

                    The content diagnostics page contains flow diagnostics as well as checklist diagnostics. In order to get started, you'll need to enter a user ID. If you don't know a user ID to enter, you can find one by clicking "Details" in the "User Identified" row via the Appcues debugger.

                    3. See the diagnostics

                    Once you enter the user ID and page, you will see the checklists for which the user is eligible and ineligible. For a detailed view, simply click on the checklist row. It will expand to show the criteria Appcues uses to evaluate whether or not a user is eligible or ineligible.

                    Do you have feedback on testing checklists? Email us at feedback@appcues.com and let us know - we'd love to hear from you and use your thoughts to build an experience that works perfectly for you and your team!

                    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!

                    Was this article helpful?

                    Yes
                    No
                    Give feedback about this article

                    Related Articles

                    • Testing Flows
                    • Diagnostics Tool
                    • Why isn't my Flow showing?
                    • Troubleshooting NPS
                    • Why isn't a step showing?
                    DON'T TAKE OUR WORD FOR IT

                    Start building with Appcues for free

                    Try before you buy
                    No credit card required
                    Support included
                    Start building for freeBook a demo
                    or take an interactive tour
                    Appcues logo

                    Product

                    In-app messaging
                    Email
                    Push notifications
                    Workflows
                    Data
                    How it works
                    Pricing
                    What's new

                    Use cases

                    Onboarding
                    Free-trial conversion
                    Feature adoption
                    Feedback
                    Support

                    Integrations

                    Why connect
                    All integrations
                    All workflows

                    Company

                    About
                    Careers
                    HIRING
                    Why Appcues
                    Teams
                    Customers

                    Support

                    Request a demo
                    Start free trial
                    Developer Docs
                    Help Center
                    Customer Success
                    Contact

                    Resources

                    Product Adoption Academy
                    Courses
                    Workshops
                    Templates
                    Examples
                    Made with Appcues
                    The Appcues Blog
                    PLG Collective
                    Product-led Experience Report
                    The Product Experience Playbook
                    The Product-Led Growth Flywheel
                    © 2025 Appcues. All rights reserved.
                    SecurityTerms of ServiceWebsite Terms of UsePrivacy PolicyCookie Preferences
                    Expand