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
  • Best Practices
  • Pro Tips

Pro Tip: Diagnosing Issues

Written by Sofia Domingues

Updated at June 11th, 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

                    Not everything will work the first time that it's set up, or sometimes something will be working and then something will suddenly go wrong!
                    There are a few Appcues tools that can be used to get things running properly, this pro tip will get you pointed in the right direction.

                    Here are a few issues that might come up:
                    An experience isn't showing
                    There are issues showing in the Issues Reporting section of Flow Analytics
                    Need help with something else? Reach out to support at support@appcues.com!

                    An experience isn't showing

                    1. Make sure that Appcues is installed in the target location and make sure that there aren't any errors.
                      The Installation Testing/Debugging doc covers this in detail. The basic steps are: with the builder closed, make sure the debugger opens, check for any red warnings.
                    2. Check the trigger to make sure that the trigger is occurring.
                      Here's an example for a flow:

                      A few quick things to check for: is the trigger occurring, is there another trigger happening right after (like another qualifying page change), is the flow set to show once (and did the trigger already occur).
                    3. Look for any issues with Audience Rules (qualification).
                      This is covered in detail in the Diagnostics Tool doc.

                    There are issues showing in the Issues Reporting section of Flow Analytics

                    1. Check the issue name in the Issues Reporting section of the flow analytics.
                      Hovering over the issue name will provide the full name and in some cases, this is enough context to know the cause of the issue. Common examples are 'could not find element for selector' or 'found multiple elements'. The Issues Reporting doc will help for context as you're investigating.
                    2. For additional context on the issue export the flow history. With this, we recommend doing a full export.

                    3. Using the export, check the activity of the users experiencing the issue to confirm the context of the issue.
                      Did the issue occur on a page where the element should be valid?
                      Was there unexpected behavior from the user that may have caused the issue?
                      Are there any conditions or properties that are different between the users that are experiencing this issue and the ones that are not experiencing the issue?
                    4. Now that the investigation is done it's good to determine what to do about the issues:
                      Is the issue expected and should it be ignored?
                      Is there something obvious that should be fixed about the issue, should be flow targeting or selector be changed for the flow or step?
                      Is the issue unexpected or unclear, if so reach out to support!

                    Was this article helpful?

                    Yes
                    No
                    Give feedback about this article

                    Related Articles

                    • Pro Tip: Event Triggering vs Event Targeting
                    • Pro Tip: Wildcards vs. Regex
                    • Pro Tip: Relaunch a Flow Using a Permalink
                    • Pro Tip: Flow History Reset
                    • Pro Tip: Quick Tips for Testing Your Flows
                    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