Fix a Launchpad that doesn't appear, Flows missing from its Flow list, empty Javascript blocks, inline beacons in the wrong place, and knowledge base search that returns nothing.

Launchpad isn't appearing

Work through these checks in order. Most issues are caught in the first three steps.

Check that Appcues is installed

Open the Appcues debugger on the page where you expect the Launchpad to show. Confirm all rows display green checkmarks.

If any rows show red errors, you have an installation issue that needs to be resolved before the Launchpad can appear. See Installation Testing / Debugging for next steps.

Check user eligibility

1. Click Audiences > Users and search for the affected user. See Find and inspect users.

2. Open the Eligibility tab. It lists every live experience and whether the user qualifies for it.

3. To include page and domain rules, enter the page's URL in Page URL and click Check page.

4. If the Launchpad shows Not eligible, click See why. Each group of rules shows Met or Not met:

   • Audience not met: the user doesn't match the audience rules.

   • Page not met: the page doesn't match the page or domain rules.

Check page targeting

Use Test URL targeting on the Launchpad's settings.

1. Open the Launchpad and click Settings.
2. In Where this appears, click Test URL targeting.
3. Enter the URL where you expect the Launchpad to appear. The result is Will show, Will not show, or Will show when installed (the rules match, but Appcues isn't installed on that domain).

Check the domain

Confirm the domain where you're testing is included in your Launchpad's page targeting settings. If you're testing in staging but only have your production domain selected (or vice versa), the Launchpad won't appear.

Flows aren't showing inside the Launchpad

The Launchpad appears, but the Flow list block is empty or missing expected Flows.

Flow not opted in

Flows do not appear in Launchpads automatically. Each Flow must be explicitly enabled.

1. Open the Flow and click Settings.
2. In Launchpad, confirm Allow this flow to be recalled from any Launchpad is ticked.

If the box is unchecked, the Flow won't appear in any Launchpad regardless of other settings.

"Nothing to see here" in preview

When you preview the Launchpad, the Flow list block displays "Nothing to see here at the moment." This is expected — preview mode only renders Links block content. Flows appear only during a live test (published to staging or internal testers). See Preview and test an experience.

Flow uses an event-based trigger

Flows with event-based triggers do not appear in Launchpads, even if the Launchpad option is enabled in the Flow's settings. Only Flows with page-based or manual triggers are eligible.

To check, open the Flow's Settings tab and look at When this shows. If it's set to an event, the Launchpad checkbox is greyed out.

User doesn't qualify for the Flow

Flows in the Flow list block respect their own audience targeting. If the user doesn't meet the Flow's audience rules, it won't appear.

1. Click Audiences > Users and search for the affected user.
2. Check whether the user meets the Flow's audience targeting conditions.

Also check the Flow's page targeting if Only show if the page matches is enabled — the Flow will only appear in the Launchpad when the user is on a page that satisfies the Flow's own page targeting rules.

Flows added as items in a Links block are always displayed and do not respect audience targeting. If a Links block item isn't appearing, the issue is with the Launchpad itself, not the Flow's targeting.

A Javascript block shows an empty card

Javascript blocks only run on the published Launchpad, so they stay empty in the builder and in preview. If the block is still empty on the published Launchpad, the snippet rendered nothing.

• Check the block's Snippet and its variables in the builder.
• Open your browser's console on the page and look for errors from the snippet.
• Test the snippet on its own. See Add JavaScript snippets.

Inline beacon isn't rendering correctly

These issues are specific to Launchpads using inline beacon placement, which relies on a CSS selector to position the beacon inside your page layout.

Beacon doesn't appear at all

The CSS selector may not be matching any element on the page.

1. Open the Appcues Chrome Extension and go to your Launchpad's placement settings.
2. Check the selector validation. A green checkmark with "Selector is unique and valid" confirms the selector targets exactly one element. If it shows an error, the selector needs to be updated.
3. Right-click the area where the beacon should appear in your app, select Inspect, and verify the target element exists in the DOM.

Common causes:

• The target element loads dynamically after the page renders. The Appcues SDK may evaluate the selector before the element exists. Work with your development team to confirm the element is present in the initial DOM or loaded before the Appcues SDK initializes.
• The CSS selector references a class or ID that changed. Re-select the target element in the Chrome Extension to generate an updated selector.
• The page has a different DOM structure on certain screen sizes or for certain user roles. Test the selector on the same page and in the same conditions where end users will see it.

Beacon appears in the wrong position

If the beacon renders but is misplaced, check the embedding option and selector target.

1. Open the Chrome Extension and review the placement settings:

• Inline Left: The beacon displays to the left of the content inside the target element.
• Inline Right: The beacon displays to the right of the content inside the target element.
• Overlaid: The beacon is overlaid on top of the content in the target element's area.

2. Confirm the selector is targeting the correct element — not a parent or child of the intended element. Use the browser's Inspect tool to compare.
3. If the positioning is slightly off, use the fine-tune position controls in the Chrome Extension to adjust.

Selector matches multiple elements

If the CSS selector matches more than one element on the page, the beacon may render in an unexpected location or not render at all.

1. If you see a ‘Element not unique’ error in the Extension, make the selector more specific by selecting Refine selection. Narrow it down to a unique element using Text or Order filters.

For general CSS selector guidance, see Troubleshoot element targeting.

Beacon disappears on navigation

In single-page applications (SPAs), the target element may be removed and re-rendered when the user navigates between views. The beacon may not reattach to the new element.

• Confirm the target element persists across the pages where the Launchpad is targeted. If the element is only present on certain views, adjust the Launchpad's page targeting to match only those views.
• If the element is re-rendered on every navigation, work with your development team to confirm the element's selector remains consistent after re-renders.

Multiple Launchpads appearing

If a user qualifies for more than one published Launchpad, all of them display simultaneously. This is expected behavior.

To resolve, review the audience and page targeting of each published Launchpad to ensure they don't overlap for the same users and pages. Use segments to separate audiences, or narrow page targeting so each Launchpad appears on different pages.

Knowledge base search isn't working

If search is enabled but not returning results:

• Confirm the integration shows as connected in the Launchpad's settings.
• Verify the API key hasn't been revoked or rotated since setup.
• Check that the domain value matches your knowledge base URL exactly.
• Verify that articles are public. Restricted articles don't show up in the Launchpad.
• Test the same search directly in your knowledge base to confirm articles exist and are published.

See Set up knowledge base search for full setup and troubleshooting details.

Page targeting isn't matching

Regex patterns

If using a regex pattern for URL matching, confirm:

• The operator is set to matches regex (not "contains" or "is").
• The pattern is valid. Test it with a regex tester.

AND vs OR conditions

If using multiple URL conditions, check whether they use All (AND) or Any (OR) logic.

Example of a common mistake: You want the Launchpad to appear on pages containing "account", "dashboard", or "payments." If you use All (AND), the Launchpad only appears on a URL that contains all three words simultaneously (e.g., https://yourapp.com/account/dashboard/payments) — which may not exist.

Switch to Any (OR) so the Launchpad appears on any page containing at least one of those words.

Content Security Policy blocking Appcues

Some applications use a Content Security Policy (CSP) that blocks external resources not explicitly allowed. This can prevent the Appcues SDK or builder from loading.

To check: open your browser's console (right-click > Inspect > Console tab) and look for errors that mention a Content Security Policy related to Appcues.

If you see CSP errors, your development team needs to add Appcues domains to the allow list. See Content Security Policies for the required configuration.

Still stuck?

Collect the following and contact support:

• The Launchpad's name and Experience ID (on its Settings tab, in Who changed this).
• The affected user's User ID.
• The page URL where the issue occurs.
• A screenshot or screen recording showing the problem.
• If it's an inline placement issue: a screenshot of the CSS selector and placement settings from the Chrome Extension.
• Any console errors visible in the browser's developer tools.